The Dead Internet MCP Hub
使用说明(Markdown格式)
-
项目简介 The Dead Internet MCP Hub 是一个 MCP(Model Context Protocol)服务器端实现,负责将资源、工具和提示模板等上下文能力以标准化的接口暴露给 MCP 客户端(如各类 LLM 工具链和代理)。通过 SSE 传输和 JSON-RPC 风格接口,客户端可以查询可用工具、执行工具、获取内置提示等,并在会话中进行状态管理。
-
主要功能点
- 资源与工具管理:提供注册、枚举和执行工具的能力,支持外部工具的注册与调用。
- 提示模板与上下文:支持渲染和提供用于对话的 Prompt 模板与上下文信息,帮助 LLM 客户端进行更一致的交互。
- JSON-RPC / SSE 通信:通过 JSON-RPC 风格的请求/响应,以及 SSE 传输实现实时通知与流式数据传输。
- 会话与权限:内置会话管理和简单的鉴权/令牌传递机制,便于多客户端安全访问。
- 兼容多种传输:设计为可扩展,未来可接入如 Stdio、WebSocket 等传输通道,提升集成灵活性。
-
安装步骤
- 确保系统中安装了 Python 3.x 及相关依赖环境(FastAPI、uvicorn、mcp 框架等)。
- 将 MCP Hub 服务部署为独立进程,例如直接运行服务器脚本: python3 path_to_repo/LocalInternet/services/mcp/app/main.py
- 启动后监听端口(默认实现提供 HTTP/WS/ SSE 形式的接入点,请根据实际部署配置暴露端点)。
- 使用 MCP 客户端(如 Gemini CLI、Claude Code 等)按照 MCP 规范进行连接与交互,参考下面的配置示例进行对接。
-
服务器配置(MCP客户端需要的配置信息,JSON 格式) { "server_name": "psx-grid-mcp-hub", "command": "python3", "args": [ "LocalInternet/services/mcp/app/main.py" ], "description": "启动并连接到 The Dead Internet 的 MCP Hub 服务端,用于向 MCP 客户端暴露工具、资源和提示模板等能力。" } 说明:
- server_name: MCP 服务器的唯一标识名称,客户端通过该名称区分不同的 MCP 服务器。
- command / args: 启动服务器的命令及参数,确保路径与工作目录在运行环境中可解析。
- 该配置仅用于客户端预备了解服务器位置与启动信息,实际连接仍需客户端实现对 MCP 接口的调用。
-
基本使用方法
- 客户端连接:通过 MCP 客户端的连接流程,使用上面的服务器名称和地址建立连接,完成身份认证并获取工具列表。
- 查询工具:调用 /tools 获取可用工具及其输入结构,了解需要提供的参数。
- 调用工具:使用 call 工具的方式执行具体功能,如 grid_ping、nexus_search、mirror 操作等,并按返回的文本/结构解析结果。
- 实时协作:若客户端支持 SSE,可订阅 /sse 端点以接收服务器端推送的通知与事件。