使用说明
项目简介
本项目 'RSS3 MCP 服务器' 是一个实现了 Model Context Protocol (MCP) 的服务器,它将 RSS3 API 的强大功能以标准化的 MCP 协议形式提供给各类支持 MCP 协议的 LLM 客户端(如 Claude Desktop, Cursor, ChatWise 等)。通过此服务器,LLM 可以轻松查询和利用来自去中心化网络、社交媒体平台以及 RSS3 网络本身的数据,从而扩展 LLM 的知识范围和应用场景。
主要功能点
- 开放网络数据访问: 允许 LLM 查询包括去中心化链、社交媒体、RSS3 网络在内的广泛的开放网络数据。
- 集成 RSS3 API: 充分利用 RSS3 API 提供的丰富数据接口,例如查询链上数据、社交媒体信息、RSS3 网络状态以及 AI 相关情报等。
- MCP 协议标准: 遵循 MCP 协议标准,确保与各种兼容 MCP 协议的 LLM 客户端无缝对接。
- 工具化 API: 将 RSS3 API 的各种功能封装为 MCP 工具 (Tools),方便 LLM 通过标准化的方式调用。
- 动态获取 API Schema: 提供 "API-get-input-schema" 工具,允许 LLM 在调用具体 API 前动态获取其所需的输入参数 schema,提高调用的准确性和灵活性。
安装步骤
由于这是一个 Node.js 项目,您需要先确保本地环境已安装 Node.js 和 npm (或 yarn, pnpm)。
-
克隆仓库 (可选):虽然您不需要克隆仓库也能运行,但如果您希望修改代码或深入了解项目,可以克隆仓库到本地。
git clone https://github.com/RSS3-Network/mcp-server-rss3 cd mcp-server-rss3 -
全局安装或直接运行: 该项目可以直接通过 'npx' 命令运行,无需全局安装。
服务器配置
对于 MCP 客户端(如 Claude Desktop, Cursor, ChatWise),您需要配置 MCP 服务器的启动命令。以下是针对不同客户端的配置示例,核心配置信息是一致的。
通用配置信息 (JSON 格式,无需修改,直接复制到客户端配置中):
{ "rss3": { // 服务器名称,可以自定义,例如 "rss3-server" "command": "npx", // 启动命令,通常为 npx,用于执行本地 Node.js 包 "args": [ "mcp-server-rss3" // 启动参数,这里是 mcp-server-rss3,对应 package.json 中配置的执行入口 ] } }
不同客户端配置方法:
-
Claude Desktop: 打开 Claude Desktop 的配置文件 'claude_desktop_config.json' (通常位于用户目录下),在 'mcpServers' 字段下添加上述 JSON 配置。
-
Cursor: 打开 Cursor 设置 (Settings -> Cursor Settings),点击 "MCP" 选项卡,点击 "Add new MCP Server" 并粘贴上述 JSON 配置。
-
ChatWise: 打开 ChatWise 设置 (Settings -> Tools),点击 "Add new tool",在命令 (command) 输入框中直接填写 'npx mcp-server-rss3'。
配置说明:
- '"rss3"': 这是您为该 MCP 服务器定义的名称,在客户端中用于标识和选择该服务器。您可以自定义名称,例如 '"rss3-data-server"'。
- '"command": "npx"': 指定用于启动服务器的命令。'npx' 是 npm 包执行器,用于运行本地安装的或临时的 npm 包。
- '"args": ["mcp-server-rss3"]': 'npx' 命令的参数。'"mcp-server-rss3"' 是 package.json 中定义的脚本名称,指向服务器的入口文件 'index.js'。
基本使用方法
-
启动服务器: 配置完成后,MCP 服务器会在后台自动启动 (或在您下次启动客户端时启动,取决于客户端的具体实现)。您无需手动执行 'npx mcp-server-rss3' 命令,客户端会自动管理服务器的启动和连接。
-
在 LLM 中使用工具: 在支持 MCP 协议的 LLM 客户端中,您应该能够看到 'RSS3 MCP 服务器' 提供的工具列表。您可以指示 LLM 使用这些工具来查询信息。例如,您可以向 LLM 提问:
- "最近 Vitalik 做了什么?"
- "告诉我最近的 AI 情报。"
- "展示 id 为 2048 的 rss3 chip。"
- "哪个 RSS3 节点最适合质押?"
LLM 会根据您的指令,自动选择合适的 RSS3 API 工具,并调用 'RSS3 MCP 服务器' 获取数据,最终将结果返回给您。
-
探索更多 API: 本项目集成了 RSS3 API 文档 (https://docs.rss3.io/guide/developer/api) 中描述的所有功能。您可以参考 RSS3 API 文档,了解更多可用的 API 工具,并在与 LLM 的对话中灵活运用。
注意: 'RSS3 MCP 服务器' 运行后,会在控制台 (通常是客户端的日志输出窗口或运行 'npx mcp-server-rss3' 命令的终端) 输出日志信息,例如 "RSS3 MCP Server running on stdio"。 您可以通过查看日志来确认服务器是否成功启动。
信息
分类
网页与API