Cresium MCP服务器
MCP(模型上下文协议)服务器 甲酚 API使Claude Code和Claude Desktop等人工智能工具能够通过Cresium Partner API(V3)管理交易、付款、发票和余额。
先决条件
您需要一个Cresium合作伙伴帐户:
- API密钥 (
apiKey) - 秘密 (
secret) - 公司ID (
companyId)
您可以在Cresium仪表板的合作伙伴设置下找到这些内容。
安装
克劳德代码
claude mcp add cresium-server \
-e CRESIUM_API_KEY=your_api_key \
-e CRESIUM_SECRET=your_secret \
-e CRESIUM_COMPANY_ID=your_company_id \
-- node /absolute/path/to/cresium-mcp-server/build/index.js克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"cresium": {
"command": "node",
"args": ["/absolute/path/to/cresium-mcp-server/build/index.js"],
"env": {
"CRESIUM_API_KEY": "your_api_key",
"CRESIUM_SECRET": "your_secret",
"CRESIUM_COMPANY_ID": "your_company_id"
}
}
}
}从源代码构建
git clone
cd cresium-mcp-server
npm install
npm run build环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
CRESIUM_API_KEY | 是 | 合作伙伴API密钥 |
CRESIUM_SECRET | 是 | HMAC签名的合作伙伴密钥 |
CRESIUM_COMPANY_ID | 是 | 要操作的公司ID |
可用工具
| 工具 | 说明 |
|---|---|
health_check | 检查API的可用性 |
get_balance | 获取钱包余额(余额、已锁定、已投资、可用) |
search_transactions | 使用筛选器和分页搜索交易 |
get_transaction | 按ID获取单笔交易 |
lookup_bank_address | 查找CBU/CVU/别名以获取地址ID |
create_transfer_preview | 创建传输预览(不执行) |
confirm_transaction | 确认预览的交易 |
create_signature_request | 请求签名者批准交易 |
create_payments | 创建付款(应付账款) |
create_invoices | 创建发票(应收账款) |
list_payments | 列出所有公司付款 |
list_invoices | 列出所有公司发票 |
典型工作流程
发送转账
- 查找目的地:
lookup_bank_address带有CBU/CVU/别名 - 创建预览:
create_transfer_preview包含地址ID、金额和货币 - 请求批准:
create_signature_request具有交易ID(签名者从仪表板批准)
检查余额和交易
- 获取余额:
get_balance查看每种货币的可用资金 - 搜索交易记录:
search_transactions带有日期或状态过滤器 - 获取详细信息:
get_transaction具有特定的交易ID
认证
所有请求都使用HMAC-SHA256进行签名。服务器透明地处理此问题:
signature = HMAC-SHA256("{timestamp}|{METHOD}|{path}|{body}", secret) → base64每次请求时发送的标头: x-api-key, x-company-id, x-timestamp, x-signature
许可证
麻省理工学院
