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 客户端的配置,将服务器的启动命令与参数填入连接信息,即可与服务器进行工具调用、查询资源等操作。
    • 常见操作
      • 列出可用工具
      • 调用某个工具(如查询余额、转账等)
      • 根据需要开启写权限、配置地址白名单、设置每日限额等安全选项

服务器信息