Free Crypto News MCP Server
使用说明(简体中文,包含关键步骤与要点)
-
项目简介
- 该仓库实现了一个 MCP 服务器,用于向 LLM 客户端提供资源托管、工具注册与执行,以及 Prompt 模板的渲染。核心目标是为大型语言模型提供可扩展的上下文和外部功能能力,支持多种传输方式(包括 stdio 与 HTTP/SSE)。
-
主要功能点
- MCP 核心对接:服务器实现对 MCP 请求/响应的处理,暴露工具集合、资源访问能力及提示渲染入口。
- 资源与工具管理:定义并暴露大量“工具”(Tools),允许 LLM 调用外部功能,提供资源和能力描述。
- 传输模式支持:可在 stdio 模式(本地 Claude/桌面)或 HTTP/SSE 模式(ChatGPT Developer Mode)之间切换,方便本地或远程集成。
- 安全与会话:实现会话管理、能力声明及基本的请求/响应封装,确保与 MCP 客户端的互操作性。
- 附加组件:包含一个独立的 WebSocket 实时推送服务器,以及一个 HTTP/SSE MCP 传输实现,作为对 MCP 的补充实现。
-
安装与运行
- 运行环境:Node.js。仓库中提供了 MCP 服务器的核心实现,以及可独立运行的 HTTP/SSE 服务。
- 运行方式(示例,不作为代码块展示,供理解即可):
- 选择 stdio 模式(默认):node mcp/index.js(在仓库根路径运行,适用于 Claude Desktop 连接)。
- 选择 HTTP/SSE 模式:node mcp/index.js --http 或直接运行 mcp/http-server.js 以启用 HTTP/SSE 服务。
- 服务器启动后,MCP 客户端(如 Claude/ChatGPT 等)需要指向相应传输端点,完成初始化和工具调用等交互。
-
服务器配置(MCP 客户端需要,但不需要了解实现细节)
- 配置字段(示例性描述,供理解):
- serverName: 一个标识该 MCP 服务器的名称,例如 "crypto-news"。
- command: 启动 MCP 服务器的命令,如 "node"。
- args: 启动参数,例如 ["/path/to/free-crypto-news/mcp/index.js"],若使用 HTTP 模式则需相应调整为 "--http" 等参数。
- transport: 传输模式标识,建议在客户端配置中注明支持的传输类型(stdio 或 http)。
- 备注:仓库内提供多种入口,实际配置请按你使用的 MCP 客户端文档格式组织。
-
基本使用方法
- 在本地使用 stdio 模式的 MCP 服务时,直接启动 mcp/index.js,随后在 MCP 客户端中选择该服务器并进行初始化、工具列出与调用等操作。
- 在远程/开发者模式使用 HTTP/SSE 时,按 MCP 客户端要求配置服务器地址并使用 SSE 端点进行会话初始化、工具调用和结果获取。
- 常见流程包括:初始化 MCP 会话 → 获取工具列表 → 调用特定工具(如 get_crypto_news、get_breaking_news 等)→ 处理返回的 JSON-RPC 数据结构。
-
注意事项
- MCP 与客户端的具体实现和版本兼容性请参照仓库内 mcp/README.md 的文档说明。
- 若要自托管,请确保网络暴露端口与传输协议配置正确,尤其是在生产环境中考虑安全性、鉴权与速率限制等方面。