io.github.hampsterx/claude-mcp-bridge
NPM · CLAUDE-MCP-BRIDGE · SCANNED SEP 20
Wraps Claude Code CLI as MCP tools: query, search, structured, ping, listSessions.
Available components
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. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 98 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to hampsterx/claude-mcp-bridge). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 48 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability63
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 1041 tokens (~208/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management90
- Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 5 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.hampsterx/claude-mcp-bridge server?
io.github.hampsterx/claude-mcp-bridge runs locally as an npm package, launched with npx -y claude-mcp-bridge. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · claude-mcp-bridge
claude mcp add hampsterx-claude-mcp-bridge -- npx -y claude-mcp-bridge
{
"mcpServers": {
"hampsterx-claude-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"claude-mcp-bridge"
]
}
}
} {
"servers": {
"hampsterx-claude-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"claude-mcp-bridge"
]
}
}
} codex mcp add hampsterx-claude-mcp-bridge -- npx -y claude-mcp-bridge
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"hampsterx-claude-mcp-bridge": {
"type": "local",
"command": [
"npx",
"-y",
"claude-mcp-bridge"
],
"enabled": true
}
}
} openclaw mcp add hampsterx-claude-mcp-bridge --command npx --arg -y --arg claude-mcp-bridge
mcp_servers:
hampsterx-claude-mcp-bridge:
command: "npx"
args: ["-y", "claude-mcp-bridge"] {
"McpServers": {
"hampsterx-claude-mcp-bridge": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"claude-mcp-bridge"
]
}
}
} assistant mcp add hampsterx-claude-mcp-bridge -t stdio -c npx -a -y claude-mcp-bridge
{
"mcpServers": {
"hampsterx-claude-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"claude-mcp-bridge"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 −3
- Stability: pass → 0.80 functional
- 16 Sept 26 +1
- Stability: 0.97 → pass security
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Sept 26 −3
- Stability: pass → 0.80 functional
- 9 Sept 26 +1
- Stability: 0.97 → pass security
- 7 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/claude-mcp-bridge@0.7.1
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | hampsterx/claude-mcp-bridge |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/hampsterx/claude-mcp-bridge/.github/workflows/publish.yml@refs/tags/v0.7.1 |
| Rekor log index | 2331533993 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:21aff9b850db8e86cb0942d5dc2a0ce18c5a658fb1ae601cb5815f3acc241e6fe470e8f79fbbcfa7830c4adf7a5f116321aee691e42be42660e35d4b2 |
Background: How many MCP packages publish verified provenance →
Dependencies 98 packages
| Packages resolved | 98 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
listSessions List Sessions ~57
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).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
ping Health Check ~33
Health check: verifies Claude CLI is installed and authenticated, reports versions, capabilities, and configuration. No cost (local check only).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
query Claude Query ~415
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
search Web Search ~261
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
structured Structured Output ~275
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | What to generate or extract |
| schema | string | yes | 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 |
No output schema declared.
No examples provided.
What is the io.github.hampsterx/claude-mcp-bridge server?
io.github.hampsterx/claude-mcp-bridge is listed in the public MCP registry as io.github.hampsterx/claude-mcp-bridge. Wraps Claude Code CLI as MCP tools: query, search, structured, ping, listSessions. This page covers its npm package (claude-mcp-bridge).
Is the io.github.hampsterx/claude-mcp-bridge server safe to use?
io.github.hampsterx/claude-mcp-bridge scores 91 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.hampsterx/claude-mcp-bridge server expose?
io.github.hampsterx/claude-mcp-bridge exposes 5 tools: query, structured, search, listSessions, ping. Their descriptions and schemas cost roughly 1,041 tokens of context every time the server is loaded.
Is the io.github.hampsterx/claude-mcp-bridge server still maintained?
io.github.hampsterx/claude-mcp-bridge is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.hampsterx/claude-mcp-bridge server under?
io.github.hampsterx/claude-mcp-bridge declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.