MCP Server

🚀 Counterparty MCP Server

AIエージェントに、ビットコイン上に構築されたトークンプロトコルであるCounterparty との対話機能を提供します。残高、資産、注文、ディスペンサーの照会、トランザクションの作成、署名、ブロードキャストが可能です。すべてのMCP互換クライアントで動作します。

🚀 クイックスタート

📦 インストール

ダウンロードは不要です。以下の設定をAIクライアントに追加するだけです。npx が自動的にサーバーを取得して実行します。

Claude Desktop

claude_desktop_config.json に追加します（場所の確認方法）:

{
  "mcpServers": {
    "counterparty": {
      "command": "npx",
      "args": ["-y", "@21e14/mcp-server"]
    }
  }
}

Claude Code

claude mcp add counterparty -- npx -y @21e14/mcp-server

署名付きの場合（署名とブロードキャスト を参照）:

claude mcp add counterparty \
  -e SIGNER_PRIVATE_KEY=L1aW4aubDFB7yfras2S1mN... \
  -e SIGNER_ADDRESS=bc1q... \
  -- npx -y @21e14/mcp-server

サーバーの管理は、claude mcp list、claude mcp get counterparty、または claude mcp remove counterparty を使用します。

VS Code (Copilot)

Ctrl + Shift + P を押して、MCP: Add Server → Stdio を選択し、以下を入力します:

npx -y @21e14/mcp-server

または、.vscode/mcp.json に追加します:

{
  "servers": {
    "counterparty": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@21e14/mcp-server"]
    }
  }
}

Cursor

.cursor/mcp.json に追加します:

{
  "mcpServers": {
    "counterparty": {
      "command": "npx",
      "args": ["-y", "@21e14/mcp-server"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します:

{
  "mcpServers": {
    "counterparty": {
      "command": "npx",
      "args": ["-y", "@21e14/mcp-server"]
    }
  }
}

ChatGPT

ChatGPTデスクトップで、Settings → Beta Features → MCP Servers に移動し、以下を追加します:

npx -y @21e14/mcp-server

任意のMCPクライアント

このサーバーは標準入出力を使用します。任意のMCP互換クライアントを以下に向けます:

npx -y @21e14/mcp-server

以上です。これでエージェントはCounterpartyネットワークを照会し、未署名のトランザクションを作成できます。

署名とブロードキャスト

エージェントにトランザクションの署名とブロードキャストを許可するには、署名キーを追加します:

{
  "mcpServers": {
    "counterparty": {
      "command": "npx",
      "args": ["-y", "@21e14/mcp-server"],
      "env": {
        "SIGNER_PRIVATE_KEY": "L1aW4aubDFB7yfras2S1mN...",
        "SIGNER_ADDRESS": "bc1q..."
      }
    }
  }
}

これにより、sign_and_broadcast ツールが有効になります。署名はAIエージェントに資金を支出する能力を与えます — 以下のセキュリティガイダンスを読んでください。

ボットウォレットパターン（推奨）

1. オフラインで新しいキーペアを生成します。 既存のウォレットを再利用したり、AIを通じてキーを生成しないでください。
2. リスクを承知した分だけの資金を入れます。 これがあなたの影響範囲です。
3. セグウィットアドレスを使用します。 P2WPKH (bc1q...)、P2SH - P2WPKH (3...)、またはP2TR (bc1p...)。レガシーP2PKHはサポートされていません。
4. 1つのキーに1つのアドレスを使用します。 HD派生は行いません。Counterpartyは設計上、アドレスを再利用します。
5. 主要な保有資産は別の場所に保管します。 ボットウォレットは使い捨てです。

作成専用モード

署名キーがない場合、サーバーはすべての作成ツールから未署名のトランザクションの16進数を返します。独自のツールでオフラインで確認して署名できます。これが最も安全なモードです。

トランザクション検証

sign_and_broadcast は、署名前にトランザクションから埋め込まれたOP_RETURNデータを抽出して返します — APIを信頼せずにローカルで行われるため、エージェントは要求された内容とトランザクションが一致することを検証できます。

環境変数

💻 使用例

ツール

照会 (24)

作成 (18)

ビットコイン (4)

ユーティリティ (3)

📚 ドキュメント

サーバーには、エージェントがコンテキストとして読むことができるプロトコルドキュメントが含まれています:

• counterparty://protocol-overview — 資産、数量、DEX、ディスペンサー、フェアミンティング、手数料、および運用ヒント
• counterparty://xcp420-standard — XCP - 420フェアランチ標準
• counterparty://quick-start — 一般的な操作のステップバイステップのワークフロー

開発

git clone https://github.com/XCP/mcp-server.git
cd mcp-server
npm install
npm test

ローカルでテストするには:

{
  "mcpServers": {
    "counterparty": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"]
    }
  }
}

📄 ライセンス

MIT