Knowledge Bridge

Python Version License: MIT MCP HTTP Stars

v0.2 MCP-compatible knowledge bridge with tools + resources + prompts, local BM25 KB, in-process client, and a token-guarded HTTP companion (stdlib only).
Independent protocol-layer demo for Cursor / custom agents — not an SDK re-export.

Related: lite-react-agent · hybrid-rag-kit

---

What's new in v0.2

Addition	Why
prompts/list + prompts/get	Full-er MCP surface for agent workflows
HTTP companion	/tools, /tools/call, /resources, /prompts with Bearer token
Auth stub	MCP_BRIDGE_TOKEN (default dev-token)

---

Quickstart

git clone https://github.com/Brian20040323/mcp-knowledge-bridge.git
cd mcp-knowledge-bridge
python -m examples.demo_protocol
python -m mcp_bridge.server          # stdio MCP
python -m mcp_bridge.http_server     # HTTP on :8765

curl -H "Authorization: Bearer dev-token" http://127.0.0.1:8765/tools

Cursor MCP config

{
  "mcpServers": {
    "knowledge-bridge": {
      "command": "python",
      "args": ["-m", "mcp_bridge.server"],
      "cwd": "/absolute/path/to/mcp-knowledge-bridge"
    }
  }
}

---

Independence thesis

MCP hype is real; most demos hide behind opaque SDKs. This bridge keeps JSON-RPC framing, tool schemas, resources, and prompts readable in one repo, so you can explain protocol design in interviews.

---

License

MIT © Brian20040323