MCP Server

🚀 Counterparty MCP 服務器

賦予 AI 代理與 Counterparty（基於比特幣構建的代幣協議）進行交互的能力。可以查詢餘額、資產、訂單和分發器信息，還能編寫、簽署和廣播交易。該服務器可與任何兼容 MCP 的客戶端配合使用。

🚀 快速開始

無需下載，只需將以下配置添加到你的 AI 客戶端中。npx 會自動獲取並運行服務器。

Claude 桌面版

添加到 claude_desktop_config.json（如何查找）：

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

Claude 代碼版

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 網絡並編寫未簽名的交易。

✨ 主要特性

• 賦予 AI 代理與 Counterparty 協議交互的能力，可進行查詢、編寫、簽署和廣播交易等操作。
• 支持多種 AI 客戶端，如 Claude、VS Code、Cursor、Windsurf、ChatGPT 等。
• 提供多種工具，涵蓋查詢、編寫、比特幣相關操作和實用工具等功能。

📦 安裝指南

無需下載，只需將配置添加到相應的 AI 客戶端中，npx 會自動獲取並運行服務器。具體配置方法見 快速開始 部分。

💻 使用示例

基礎用法

在 Claude 代碼版中添加服務器：

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

高級用法

在 Claude 代碼版中添加服務器並進行簽名：

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

📚 詳細文檔

簽名與廣播

若要讓代理簽署和廣播交易，需添加簽名密鑰：

{
  "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. 一密鑰一地址：不使用 HD 派生。Counterparty 設計上會重複使用地址。
5. 將主要資產存放在其他地方：機器人錢包是一次性的。

僅編寫模式

在沒有簽名密鑰的情況下，服務器會從所有編寫工具返回未簽名的交易十六進制數據。你可以使用自己的工具離線審查和簽名。這是最安全的模式。

交易驗證

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 許可證。