Cryptocurrency Daemon MCP Server (BETA)

加密货币守护进程 MCP 服务（BETA）

一个用于与加密货币守护进程 RPC 接口交互的模型上下文协议（MCP）服务。此服务可让 AI 助手以受控方式帮助管理和操作加密货币节点。

⚠️ 重要安全警告 ⚠️

此软件允许 AI 系统与加密货币守护进程交互。请仔细阅读此警告：

1. 运行此 MCP 服务会让 AI 系统能够：

   • 发送交易
   • 访问钱包信息
   • 修改钱包设置
   • 查看私密数据
   • 执行守护进程命令

2. 潜在风险包括：

   • 未经授权的交易导致资金损失
   • 私密信息泄露
   • 意外修改钱包或守护进程
   • 配置不当可能引发安全漏洞

3. 必须采取的安全措施：

   • 使用资金有限的独立钱包进行 AI 交互
   • 切勿允许访问包含大量资产的钱包
   • 配置严格的 RPC 权限
   • 监控所有 AI 与守护进程的交互
   • 定期对配置进行安全审计
   • 备份所有重要数据

此软件处于 BETA 阶段。使用风险自负。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Cryptocurrency Daemon Server：

npx -y @smithery/cli install @raw391/coin_daemon_mcp --client claude

1. 安装软件包

你可以通过 npm 安装此软件包：

npm install @raw391/coin-daemon-mcp

2. 配置 Claude Desktop

要将此 MCP 与 Claude Desktop 配合使用，你需要修改 Claude Desktop 配置。配置文件位于：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

将以下内容添加到配置中：

{
  "mcpServers": {
    "cryptocurrency": {
      "command": "npx",
      "args": [
      "-y",
        "@raw391/coin-daemon-mcp"
      ],
      "env": {
        "CONFIG_PATH": "path/to/your/config.json"
      }
    }
  }
}

3. 创建配置文件

为你的加密货币守护进程创建配置文件。以下是一些配置示例：

基本的单守护进程配置

{
  "daemons": [
    {
      "coinName": "zcash",
      "nickname": "zec-main",
      "rpcEndpoint": "127.0.0.1:8232",
      "rpcUser": "your-rpc-user",
      "rpcPassword": "your-rpc-password"
    }
  ]
}

多守护进程配置

{
  "daemons": [
    {
      "coinName": "zcash",
      "nickname": "zec-main",
      "rpcEndpoint": "127.0.0.1:8232",
      "rpcUser": "zec-user",
      "rpcPassword": "zec-password"
    },
    {
      "coinName": "bitcoin",
      "nickname": "btc-main",
      "rpcEndpoint": "127.0.0.1:8332",
      "rpcUser": "btc-user",
      "rpcPassword": "btc-password"
    }
  ]
}

使用数据目录的高级配置

为遵循最佳安全实践，你可能还需要使用文件系统 MCP 来管理守护进程数据。以下是同时配置两者的方法：

{
  "mcpServers": {
    "cryptocurrency": {
      "command": "npx",
      "args": [
        "-y",
        "@raw391/coin-daemon-mcp"
      ],
      "env": {
        "CONFIG_PATH": "C:/CryptoConfig/daemon-config.json"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/CryptoData"
      ]
    }
  }
}

4. 配置加密货币守护进程

确保加密货币守护进程的配置文件（例如 zcash.conf、bitcoin.conf）具有适当的 RPC 设置：

server=1
rpcuser=your-rpc-user
rpcpassword=your-rpc-password
rpcallowip=127.0.0.1

5. 开始使用 MCP

完成配置后，重启 Claude Desktop。你应该会看到以下可用的新工具、资源和提示词：

• 发送交易
• 查询余额
• 管理钱包
• 监控守护进程状态
• 了解加密货币
• 以及更多

MCP 功能

此服务提供三种类型的 MCP 能力：

工具

1. 交易管理

   • send-coins：发送透明交易
   • zsend-coins：发送屏蔽交易（适用于隐私币）
   • shield-coins：将透明资金转换为屏蔽资金

2. 钱包操作

   • get-balance：查询余额
   • execute-command：执行任何受支持的 RPC 命令

3. 守护进程管理

   • check-status：获取守护进程信息

资源

访问有用的数据和文档：

1. 文档资源

   • crypto://{coinType}/help：获取特定加密货币的详细文档
   • daemon://{name}/help：获取特定守护进程的帮助文本

2. 交易历史

   • daemon://{name}/transactions：查看近期交易历史

提示词

常见工作流的预构建模板：

1. 交易指引

   • send-transaction-template：生成用于构建交易的引导式提示词

2. 分析模板

   • balance-analysis：分析钱包余额和资金分布
   • daemon-diagnostic：对守护进程执行健康检查

安全最佳实践

1. 分开使用钱包

   • 为 AI 交互创建专用钱包
   • 可访问的钱包中只保留最低限度的资金
   • 开发时使用测试网络

2. RPC 安全

   • 使用强度高且唯一的 RPC 凭据
   • 仅启用必要的 RPC 命令
   • 将 RPC 访问限制为 localhost
   • 监控 RPC 日志

3. 数据管理

   • 定期备份钱包
   • 安全存储配置文件
   • 监控所有交易
   • 定期进行安全审计

使用示例

以下是 Claude 如何协助完成常见任务：

1. 检查状态： “Zcash 守护进程的当前状态如何？”

2. 管理余额： “我所有地址的当前余额是多少？”

3. 了解加密货币： “你能解释一下 Zcash 的屏蔽交易如何运作吗？”

4. 发送交易： “你能帮我向地址 xxx 发送 0.1 ZEC 吗？”

故障排除

1. 连接问题

   • 确认守护进程正在运行
   • 检查 RPC 凭据
   • 确保端口号正确
   • 确认可以访问 localhost

2. 权限问题

   • 检查文件权限
   • 确认 RPC 用户权限
   • 确保配置路径正确

3. 交易问题

   • 确认资金充足
   • 检查网络连接
   • 确保守护进程已同步

支持

• GitHub Issues：错误报告和功能请求
• Discussions：一般问题和社区支持
• 安全问题：发送邮件至 [email protected]

许可证

MIT 许可证，并附加加密货币操作免责声明。详情请参阅 LICENSE。

贡献

贡献指南请参阅 CONTRIBUTING.md。