# io.github.hampsterx/claude-mcp-bridge (npm · claude-mcp-bridge)

Wraps Claude Code CLI as MCP tools: query, search, structured, ping, listSessions.

- Trust score: 38/100 (low)
- Change this week: −5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `claude-mcp-bridge`: 38/100 (this document), [markdown](https://verifymcp.io/servers/hampsterx-claude-mcp-bridge/claude-mcp-bridge.md), [page](https://verifymcp.io/servers/hampsterx-claude-mcp-bridge/claude-mcp-bridge)

## Channel facts

- Registry: `npm`
- Package: `claude-mcp-bridge`
- Version: `0.7.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 63/100
  - No malware found by supply-chain analysis.
  - CVE data not yet available for this package.
  - No install/post-install scripts declared.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to hampsterx/claude-mcp-bridge).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 0/100
  - Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet.
- **Capabilities**: 0/100
  - Protocol version not yet verified: we do not have a sandbox capture of the MCP handshake this version of the package performs yet.

**Unverified: 4 categories.** Categories scored 0 because our sandbox run of this package has not given us the schema these checks need to read. That is a gap on our side rather than a finding about the package, and we only credit what we can confirm, so the score stands at 0 until the capture succeeds. We are working through the fleet, so this normally clears without any action from you.

## Install

### Claude

```bash
claude mcp add hampsterx-claude-mcp-bridge -- npx -y claude-mcp-bridge
```

### Codex

```bash
codex mcp add hampsterx-claude-mcp-bridge -- npx -y claude-mcp-bridge
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hampsterx-claude-mcp-bridge": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "claude-mcp-bridge"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add hampsterx-claude-mcp-bridge --command npx --arg -y --arg claude-mcp-bridge
```

### Hermes

```yaml
mcp_servers:
  hampsterx-claude-mcp-bridge:
    command: "npx"
    args: ["-y", "claude-mcp-bridge"]
```

### Other

```json
{
  "mcpServers": {
    "hampsterx-claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 38, −38)

- [security regression] Stability: 0.23 → unverified
- [security regression] Known CVEs: partial → unverified
- [functional regression] Dependency health: partial → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional] First check of Schema quality: unverified
- [functional] Package version: 0.7.0 → 0.7.1

### 2026-08-02 (score 76, +58)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] The attested source repository moved: hampsterx/claude-mcp-bridge
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] Schema quality: unverified → good
- [functional] First check of Schema quality: unverified
- [functional] Licence: MIT

### 2026-07-31 (score 18, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 25, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 43)

First indexed and scored.

## MCP tools (5)

### `query` (~415 tokens)

Claude Query

Execute a prompt via Claude Code CLI with optional file context and session resume. Claude is an AI coding agent that can generate, analyze, refactor, and explain code.

Capabilities: code generation and refactoring, code analysis and explanation, file understanding (text and images), multi-turn conversations via sessionId.

Cost: Default model is Sonnet (~$0.01-0.10/call). Use effort="low" for simple tasks, effort="high" + model="opus" for complex analysis. Set maxBudgetUsd to cap per-call cost (recommended for effort="max" or model="opus").

Tips:
\- Set workingDirectory to the target repo for project-aware responses.
\- Break complex tasks into focused prompts rather than one large request.
\- Resume multi-turn conversations with sessionId from a previous response's metadata.
\- Include relevant files via the files parameter for targeted context (text files inlined in prompt, images trigger allowed-tools mode).
\- Use noSessionPersistence=true for stateless one-shot calls.

Input parameters:

- `effort` (string): Effort level: low, medium, high, or max (passed to --effort)
- `files` (array): File paths (text or images) relative to workingDirectory
- `maxBudgetUsd` (number): Maximum cost budget in USD for this call (passed to --max-budget-usd)
- `maxResponseLength` (integer): Soft limit on response length in words
- `model` (string): Model alias or full Claude model name
- `noSessionPersistence` (boolean): Disable session persistence for ephemeral print calls
- `prompt` (string, required): The prompt to send to Claude
- `resetSession` (boolean): Clear stored session state before execution (use with sessionId to start fresh)
- `sessionId` (string): Claude session ID to resume with --resume
- `timeout` (number): Timeout in milliseconds (default: 60000, image queries: 120000)
- `workingDirectory` (string): Working directory for file resolution and CLI execution

### `structured` (~275 tokens)

Structured Output

Generate JSON conforming to a provided JSON Schema. Uses Claude CLI's native --json-schema flag for validated output (not client-side validation).

Use for: data extraction from text/files, classification, entity parsing, or any task needing machine-parseable output.

Cost: Similar to query (~$0.01-0.10/call). Schema complexity doesn't significantly affect cost.

Tips:
\- Pass the JSON Schema as a JSON string in the schema parameter.
\- Schema max size: 20KB. Keep schemas focused for reliable output.
\- For extraction tasks, include source text via the files parameter or inline in the prompt.

Input parameters:

- `files` (array): Text file paths to include as context
- `maxBudgetUsd` (number): Maximum cost budget in USD for this call (passed to --max-budget-usd)
- `model` (string): Model alias or full Claude model name
- `noSessionPersistence` (boolean): Disable session persistence for ephemeral print calls
- `prompt` (string, required): What to generate or extract
- `schema` (string, required): JSON Schema as a JSON string
- `sessionId` (string): Claude session ID to resume with --resume
- `timeout` (number): Timeout in milliseconds (default: 60000)
- `workingDirectory` (string): Working directory for file resolution and CLI execution

### `search` (~261 tokens)

Web Search

Web search via Claude Code CLI using WebSearch and WebFetch tools. Searches the web and synthesizes a comprehensive answer with source URLs.

Use for: current information, documentation lookups, API references, comparing libraries, and research questions.

Cost: Typically ~$0.02-0.05/search with Sonnet.

Tips:
\- Ask specific, focused questions for best results.
\- Results include source URLs for verification.
\- Use maxResponseLength to control response verbosity.
\- Increase timeout for complex research queries that may require multiple web fetches.

Input parameters:

- `effort` (string): Effort level: low, medium, high, or max (default: medium for search)
- `maxBudgetUsd` (number): Maximum cost budget in USD for this call (passed to --max-budget-usd)
- `maxResponseLength` (integer): Soft limit on response length in words
- `model` (string): Model alias or full Claude model name
- `noSessionPersistence` (boolean): Disable session persistence for ephemeral print calls
- `query` (string, required): Search query or question
- `sessionId` (string): Claude session ID to resume with --resume
- `timeout` (number): Timeout in milliseconds
- `workingDirectory` (string): Working directory for the CLI

### `listSessions` (~57 tokens)

List Sessions

List active Claude CLI sessions tracked by this server. Returns session metadata (IDs, models, timing, turn counts, cumulative cost) for orchestration. Use to check available sessions before resuming with sessionId. No cost (local lookup only).

### `ping` (~33 tokens)

Health Check

Health check: verifies Claude CLI is installed and authenticated, reports versions, capabilities, and configuration. No cost (local check only).

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/hampsterx-claude-mcp-bridge/claude-mcp-bridge#diagnostics

## Score history

- 2026-08-03: 38
- 2026-08-02: 76
- 2026-08-01: 18
- 2026-07-31: 18
- 2026-07-30: 25
- 2026-07-28: 43
- 2026-07-27: 43

## Links

- npm package: https://www.npmjs.com/package/claude-mcp-bridge
- Socket report: https://socket.dev/npm/package/claude-mcp-bridge
- Repository: https://github.com/hampsterx/claude-mcp-bridge
- Changelog RSS feed: https://verifymcp.io/servers/hampsterx-claude-mcp-bridge/claude-mcp-bridge/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/hampsterx-claude-mcp-bridge/claude-mcp-bridge/changelog.json
- HTML version of this page: https://verifymcp.io/servers/hampsterx-claude-mcp-bridge/claude-mcp-bridge