mcp-bridge
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-bridge: a safe MCP server over your documents and invoice checks
A reference build of a Model Context Protocol (MCP) server: lets Claude Desktop, Claude Code, ChatGPT-style clients or any MCP client call your tools safely. Six read-only tools, no network, no model calls, zero running cost.
Tool | Does |
| BM25 search over a folder of .md/.txt. Verbatim passages with file, section, line. |
| Read part of one file (sandboxed path, line range) |
| What can be searched, and which files were skipped and why |
| Recompute subtotal, tax, discount, total from line items (Decimal, never float). Flags ambiguous amounts like |
| Exact, near (one character changed) and possible duplicates |
| Health, uptime, counts, limits |
Run it
pip install -r requirements.txt
set MCPBRIDGE_DOCS_ROOT=demo_docs (Windows; export on Mac/Linux)
set PYTHONPATH=src
python -m mcpbridgeClaude Desktop / any MCP client config:
{ "mcpServers": { "mcp-bridge": { "command": "python", "args": ["-m", "mcpbridge"],
"env": { "PYTHONPATH": "C:/path/to/mcp-bridge/src", "MCPBRIDGE_DOCS_ROOT": "C:/path/to/your/docs" } } } }Settings (all optional, bad values fall back to safe defaults): MCPBRIDGE_MAX_FILE_BYTES, _MAX_FILES, _MAX_QUERY_CHARS, _MAX_K, _MAX_OUTPUT_CHARS, _CALL_TIMEOUT_S, _MAX_CONCURRENT, _MAX_CALLS_PER_MIN, MCPBRIDGE_LOG (audit file; empty disables).
Related MCP server: Project Files Read-only MCP
What happens when things go wrong (the point of this build)
Failure | Behaviour |
Any bug inside a tool | One structured tool error |
Bad or hostile input (wrong type, empty, huge, out of range) | Rejected up front with a stable code ( |
Path traversal, absolute paths, symlink escape |
|
A tool that hangs | Abandoned at the time limit with |
Flood of calls |
|
Huge reply | Capped and flagged |
Missing / empty docs folder, binary, oversized or badly-encoded file | Server starts anyway; says exactly what is wrong; bad files are skipped and listed, never fatal |
Files change while running | Index refreshes itself; deleted files disappear, no stale hits |
Prompt injection inside a document | Returned as data with an untrusted-content notice; tools are read-only so there is nothing to hijack |
Audit log cannot be written | Reported on stderr; the call still succeeds |
Protocol corruption | Nothing is ever printed to stdout except protocol messages |
Every row above has a test. pytest runs 52 tests, including an end-to-end suite that spawns the server and attacks it over the real MCP protocol.
Honest limits
Search is keyword (BM25), not semantic. It is fast, free and explainable; a semantic/vector layer is an add-on (see the Ask-My-Shop project).
weak_matchis a heuristic (share of question words found), not proof.Invoice tools check numbers you give them; they do not read PDFs and cannot prove a vendor is real.
A timed-out call is abandoned, not killed (Python threads); bounded inputs keep this theoretical.
The symlink-escape test is skipped on Windows without developer mode.
Pinned to the MCP Python SDK 1.x (
mcp<2); 2.x renamed its server API.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Safety tools for AI agents: safe page reader, prompt-injection, secrets, PII and MCP server scans
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
AIProcurement.club offers 42 MCP tools: 27 procurement specialists, 6 fixed workflows, 2 saved-report recovery tools and 7 read-only evidence tools. Five file tools provide local PDF/DOCX/PNG/JPEG extraction, English OCR, page quotes, keyword search and exact order-document checks in private temporary RAM on AIP; no corpus or Gateway memory is added. File tools require agent:read; the two existing tenant-scoped PO/invoice readers require p2p:read. For AIP-only file handling, connect directly to https://mcp.aiprocurement.club/mcp with Authorization: Bearer YOUR_SCOPED_AIP_KEY; do not submit documents or keys to directory test profiles. Paid agents are separate: external-inference consent and prepaid AIP access (from $10/job) apply. Use one stable idempotency key per paid job for saved-result replay. Setup: https://aiprocurement.club/agent-services/for-agents.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables local ChatGPT/OpenAI MCP clients to read files and search within explicitly authorized directories using read-only, policy-constrained tools.1-
- AlicenseNot gradedqualityDmaintenanceEnables secure, read-only access to local project files (including text, DOCX, PDF, and XLSX) through MCP, with strict directory whitelisting and no write, edit, or command-execution tools.1MIT
- AlicenseNot gradedqualityBmaintenanceProvides local, read-only MCP tools that expose a specified workspace's directory listing, file contents, text search, git status, and git diff to AI clients.2Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables privacy-preserving document retrieval by exposing read-only search tools over MCP, allowing agents to query local vector and structured indexes without sending data to the cloud.2MIT