Counterparty Mcp Server

Counterparty MCP 服务

让 AI Agent 能够与 Counterparty 交互——这是构建于 Bitcoin 之上的代币协议。查询余额、资产、订单和分发器。编写、签名并广播交易。兼容任何 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 客户端

该服务使用 stdio 通信。将任意兼容 MCP 的客户端指向：

npx -y @21e14/mcp-server

完成。Agent 现在可以查询 Counterparty 网络并编写未签名交易。

签名与广播

要让 Agent 签名并广播交易，请添加签名密钥：

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

这会启用 sign_and_broadcast 工具。签名会赋予 AI Agent 花费资金的能力——请阅读下方的安全指南。

Bot 钱包模式（推荐）

1. 离线生成全新的密钥对。 不要重复使用现有钱包，也不要通过 AI 生成密钥。
2. 仅为其注入你愿意承担风险的资金。 这就是风险影响范围。
3. 使用隔离见证地址。 支持 P2WPKH（bc1q...）、P2SH-P2WPKH（3...）或 P2TR（bc1p...）。不支持传统 P2PKH。
4. 一个密钥对应一个地址。 不使用 HD 派生。Counterparty 按设计会重复使用地址。
5. 将主要资产保存在其他位置。 Bot 钱包是一次性的。

仅编写模式

如果没有签名密钥，服务会从所有编写工具返回未签名交易的十六进制数据。你可以使用自己的工具审查并离线签名。这是最安全的模式。

交易验证

sign_and_broadcast 会在签名前从交易中提取并返回内嵌的 OP_RETURN 数据——此过程在本地完成，无需信任 API，因此 Agent 可以验证交易是否与请求相符。

环境变量

变量	必需	描述
COUNTERPARTY_NODE	否	Counterparty 节点 URL（默认：https://api.counterparty.io:4000）
SIGNER_PRIVATE_KEY	否	用于签名的 WIF 编码私钥
SIGNER_ADDRESS	否	签名密钥对应的 Bitcoin 地址

工具

查询（24）

工具	描述
get_balances	某地址的所有代币余额
get_balance	某地址的单项资产余额
get_asset_info	资产元数据（供应量、可分割性、发行方）
get_asset_balances	某项资产的所有持有者
get_assets	搜索／列出资产
get_issuances	某项资产的发行历史
get_owned_assets	某地址发行的资产
get_orders	DEX 订单
get_order	通过哈希查询单个订单
get_order_matches	某订单的撮合记录
get_orders_by_pair	某交易对的订单簿
get_asset_orders	涉及某项资产的订单
get_address_orders	某地址的订单
get_dispensers	分发器
get_dispenser	通过哈希查询单个分发器
get_dispensers_by_asset	某项资产的分发器
get_address_dispensers	某地址的分发器
get_dispenses	从分发器购买的记录
get_dividends	某项资产的股息分配记录
get_address_transactions	某地址的交易历史
get_sends	从某地址转出的代币
get_transaction	通过哈希查询单笔交易
get_utxo_balances	附加到 UTXO 的代币
get_latest_block	最新区块信息

组合（18）

工具	描述
compose_send	向某地址发送代币
compose_mpma	多方多资产发送
compose_order	下达 DEX 订单
compose_cancel	取消未结订单
compose_btcpay	为已撮合的 BTC 订单付款
compose_issuance	创建或更新资产（支持铭文）
compose_dispenser	创建、开启或关闭分发器
compose_dispense	从分发器购买
compose_dividend	向持有者分配股息
compose_broadcast	广播消息（支持铭文）
compose_sweep	将所有资产转移到目标地址
compose_destroy	永久销毁代币
compose_fairminter	创建公平发行（支持铭文）
compose_xcp420_fairminter	符合 XCP-420 标准的公平发行
compose_fairmint	从正在进行的公平发行中铸造
compose_attach	将代币附加到 UTXO
compose_detach	从 UTXO 分离代币
compose_movetoutxo	将 UTXO 移动到新的输出

Bitcoin（4）

工具	描述
sign_and_broadcast	签名并广播（需要签名密钥）
broadcast_transaction	广播已签名的交易
get_fee_estimate	当前费率估算
decode_transaction	解码原始交易十六进制数据

实用工具（3）

工具	描述
unpack_transaction	从交易中解码 Counterparty 消息
get_server_info	节点状态和版本
api_request	向任意端点发送原始 API 请求（完整 API 参考）

资源

该服务包含供 Agent 阅读以了解上下文的协议文档：

• 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