Cryptocurrency Daemon MCP Server (BETA)

Cryptocurrency Daemon MCP Server（ベータ版）

暗号資産デーモンの RPC インターフェースを操作するための Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI アシスタントが暗号資産ノードを制御された方法で管理、操作できます。

⚠️ 重要なセキュリティ警告 ⚠️

このソフトウェアを使うと、AI システムが暗号資産デーモンを操作できます。以下の警告をよくお読みください。

1. この MCP サーバーを実行すると、AI システムに次の操作を行う権限が与えられます。

   • トランザクションの送信
   • ウォレット情報へのアクセス
   • ウォレット設定の変更
   • 非公開データの表示
   • デーモンコマンドの実行

2. 次のようなリスクが考えられます。

   • 不正なトランザクションによる資金の損失
   • 非公開情報の漏えい
   • 意図しないウォレットまたはデーモンの変更
   • 設定が不適切な場合に発生する可能性のあるセキュリティ上の脆弱性

3. 必要な安全対策：

   • AI による操作には、残高を制限した別のウォレットを使用してください
   • 多額の資産を保有するウォレットへのアクセスは、決して許可しないでください
   • RPC 権限を厳格に設定してください
   • AI によるデーモン操作をすべて監視してください
   • 設定を定期的にセキュリティ監査してください
   • 重要なデータをすべてバックアップしてください

このソフトウェアはベータ版です。自己責任でご利用ください。

インストール

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 の機能

このサーバーは、次の 3 種類の 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 です。詳細は LICENSE をご覧ください。

貢献

貢献のガイドラインについては CONTRIBUTING.md をご覧ください。