mcpField
M
mcp-circle

mcp-circle

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-circle

mcp-circle 是 Circle 的 MCP 服务，围绕 USDC 稳定币提供钱包、支付、付款、转账及交易查询功能。适用于需要通过 USDC 结算的业务与开发者。

主要功能

  1. 0123 个 MCP 工具，覆盖钱包、支付、付款与转账
  2. 02USDC 钱包余额与交易记录查询
  3. 03支持 Webhook 通知订阅的创建与删除
  4. 04包含结算批次与拒付（chargeback）查询

适用场景

  1. 01通过 Agent 创建 USDC 转账或付款
  2. 02查询企业账户余额及交易记录
  3. 03管理 Webhook 通知订阅

MCP 相关

该项目是一个 MCP 服务，将 Circle 的钱包、支付、付款、转账、结算、拒付和通知订阅接口以工具形式提供给 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-circle": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-circle"
      ],
      "env": {
        "CIRCLE_API_KEY": "<CIRCLE_API_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-circle
需要配置的环境变量
CIRCLE_API_KEY密钥API key for circle

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-circle0.2.2

工具

23

收录的工具列表 · 更新于 2 周前

参数类型必填说明
descriptionstring否钱包描述
idempotencyKeystring是唯一的幂等键（UUID）

详细介绍

@codespar/mcp-circle

用于 Circle 的 MCP 服务——USDC 稳定币支付、付款、转账和钱包

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "circle": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-circle"],
      "env": {
        "CIRCLE_API_KEY": "your-key"
      }
    }
  }
}
Claude Code
claude mcp add circle -- npx @codespar/mcp-circle
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "circle": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-circle"],
      "env": {
        "CIRCLE_API_KEY": "your-key"
      }
    }
  }
}

工具（23 个）

工具用途
create_wallet创建新的 Circle 商业账户钱包
get_wallet按 ID 获取钱包详情
list_wallets列出所有 Circle 钱包
create_payment通过 Circle 接受 USDC 支付
get_payment按 ID 获取支付详情
create_payout从 Circle 发起付款（USDC 兑换为法币）
get_payout按 ID 获取付款详情
list_payouts列出付款，可选筛选条件
create_transfer在 Circle 钱包之间转移 USDC（或转至区块链地址）
get_transfer按 ID 获取转账详情
list_transfers列出转账，可选筛选条件
create_card注册用于入金支付的卡片数据
get_card按 ID 获取卡片详情
list_cards列出已注册的卡片
list_settlements列出结算记录（银行卡支付批次）
get_settlement按 ID 获取结算详情
list_chargebacks列出拒付记录
get_chargeback按 ID 获取拒付详情
create_subscription注册通知订阅（Webhook）
list_subscriptions列出通知订阅（Webhook）
delete_subscription删除通知订阅
get_balance获取商业账户余额
list_transactions列出交易，可选筛选条件

身份验证

Circle 使用 Bearer API 密钥进行身份验证。

沙盒 / 测试

Circle 在 api-sandbox.circle.com 提供沙盒。测试时请使用沙盒 API 密钥。

获取凭据
  1. 前往 Circle 开发者门户
  2. 创建开发者账户
  3. 生成沙盒 API 密钥
  4. 设置 CIRCLE_API_KEY 环境变量

环境变量

变量必需描述
CIRCLE_API_KEY是Circle 提供的 API 密钥

路线图

v0.2（计划中）
  • create_card_payment — 创建银行卡支付
  • create_wire_payment — 创建电汇支付
  • create_ach_payment — 创建 ACH 支付
  • get_settlement — 获取结算详情
  • list_settlements — 按筛选条件列出结算记录
v0.3（计划中）
  • smart_contract_calls — 执行智能合约调用
  • cross_chain_transfers — 跨区块链转移资产

想要贡献代码？提交 PR 或申请新工具。

链接

企业版

需要为 Agent 支付设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。