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 许可证。