Monero MCP 服务器
使用说明(Markdown 形式)
-
项目简介
- 这是一个实现 MCP 协议的服务端,用于将 Monero 钱包 RPC 接入到 MCP 客户端生态中。通过标准的 MCP JSON-RPC 接口,客户端可以查询资源、注册并执行工具、以及获取或渲染提示模板。服务器负责会话管理、能力声明、以及对工具的执行进行安全控制。
-
主要功能点
- 资源与数据访问:对钱包的余额、地址、交易记录等信息进行只读读取。
- 工具注册与执行:提供对钱包相关操作的工具集,如转账、创建地址、获取余额等,支持只读模式和受控的写操作(可通过环境变量开启写权限)。
- 提示模板与输出渲染:支持在工具调用中渲染输出,输出格式友好,便于与 LLM 交互。
- 安全防护:内置多重防护机制,包括地址白名单、两步确认、速率限制、审计日志与输入净化,降低误操作带来的风险。
- 多传输模式:基于 MCP SDK 的 stdio 传输,理论上可扩展到 SSE、WebSocket 等传输。
-
安装步骤
- 克隆仓库并安装依赖
- 安装所需依赖并构建产物
- 构建产物
- 执行构建命令生成可运行的打包文件(如 build/index.js)
- 启动与运行
- 启动前请确保 Monero 钱包 RPC 已就绪并可访问
- 使用标准 MCP 客户端连接,默认以 stdio 传输工作
- 测试与验证
- 使用仓库自带的测试脚本或 MCP Inspector 等工具进行连接测试
- 克隆仓库并安装依赖
-
服务器配置(JSON 格式) 说明:MCP 客户端需要至少知道服务器的启动命令与参数信息,以便建立连接。下面给出基于仓库实现的准确配置示例(请以实际部署路径为准)。 { "server": { "name": "monero-mcp-server", "command": "node", "args": ["/monero-mcp/build/index.js"] }, "notes": "服务器通过标准输入/输出与 MCP 客户端通信,默认启用 stdio 传输。启动前请执行 npm install 与 npm run build;启动后可通过 MCP 客户端与工具进行交互。" }
-
基本使用方法
- 启动服务器
- 依赖准备就绪后运行以上命令,服务器将输出启动信息并等待 MCP 客户端连接。
- 使用 MCP 客户端连接
- 通过 MCP 客户端的配置,将服务器的启动命令与参数填入连接信息,即可与服务器进行工具调用、查询资源等操作。
- 常见操作
- 列出可用工具
- 调用某个工具(如查询余额、转账等)
- 根据需要开启写权限、配置地址白名单、设置每日限额等安全选项
- 启动服务器