加密货币守护进程 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. 发送交易： "你能帮我发送 0.1 ZEC 到地址 xxx 吗？"

故障排除

1. 连接问题

   • 验证守护进程是否正在运行
   • 检查 RPC 凭据
   • 确保正确的端口号
   • 验证 localhost 访问

2. 权限问题

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

3. 交易问题

   • 验证是否有足够的资金
   • 检查网络连接
   • 确保守护进程已同步

支持

• GitHub Issues：错误报告和功能请求
• Discussions：一般问题和社区支持
• Security Issues：发送电子邮件至 security@pooly.ca

许可证

MIT 许可证，带有额外的加密货币操作免责声明。 有关详细信息，请参见 LICENSE。

贡献

有关贡献指南，请参见 CONTRIBUTING.md。