FinCobra MCP — 面向 Claude、Cursor 和 Codex 的加密货币结账

Model Context Protocol (MCP) 服务器，用于 FinCobra 加密货币结账和支付。可创建 BTC、USDT 和 USDC 的托管发票（结算资产来自仪表盘支付方式；金额为 USD）。适用于 Claude Code、Cursor 和 Codex。Watchlist 访问为只读。尚未发布到 npm — 请从 GitHub 安装。

文档：FinCobra Checkout MCP

fincobra-mcp 0.1.0 尚未发布到 npm。在发布之前，请从 GitHub 安装：

npx -y github:dexstandard/fincobra-mcp

使用 npx -y github:dexstandard/fincobra-mcp#v0.1.0 固定到某个源码版本。需要 Node.js 20+。

• Checkout：创建托管支付发票并读取其状态

• Watchlist：只读来源列表和手动净资产明细

这不是支付平台，也不是 Watchlist 写入 API。

工具（v0）

Checkout

没有 list_invoices 工具。Checkout API 密钥无法列出发票。

发票金额为 USD。结算资产来自仪表盘支付方式：

Watchlist（只读）

Watchlist 没有公共 API 密钥。认证使用 Watchlist Web 应用所用的 Identity session cookie。

银行、现金和房产是手动录入的产品条目，并非实时银行或产权数据源。实时的加密 USD 余额在 Watchlist UI 中计算，不在列表 API 上。服务器不会凭空生成 cryptoUsd 总额。

Watchlist 工具不会添加钱包、编辑银行、更改账单或导出税务数据。

Related MCP server: Infini Payment MCP Server

环境

可以配置 Checkout、Watchlist 或两者。未配置的模块对应的工具会返回配置错误。

开发环境源地址：https://dev.fincobra.com 和 https://watch.dev.fincobra.com。

Cursor

添加到 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（用户）：

{
  "mcpServers": {
    "fincobra": {
      "command": "npx",
      "args": ["-y", "github:dexstandard/fincobra-mcp"],
      "env": {
        "FINCOBRA_CHECKOUT_API_KEY": "fc_live_...",
        "FINCOBRA_CHECKOUT_BASE_URL": "https://fincobra.com",
        "FINCOBRA_WATCHLIST_SESSION_TOKEN": "<session-cookie-value>",
        "FINCOBRA_WATCHLIST_BASE_URL": "https://watch.fincobra.com"
      }
    }
  }
}

Claude Code

claude mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

或者将相同的 mcpServers 对象添加到 .mcp.json / ~/.claude.json。

Codex

codex mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

或者在 ~/.codex/config.toml 中：

[mcp_servers.fincobra]
command = "npx"
args = ["-y", "github:dexstandard/fincobra-mcp"]

[mcp_servers.fincobra.env]
FINCOBRA_CHECKOUT_API_KEY = "fc_live_..."
FINCOBRA_WATCHLIST_SESSION_TOKEN = "<session-cookie-value>"

本地运行

npm install
FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm start

该进程通过 stdio 使用 MCP 通信。不要将应用日志写入 stdout。

冒烟测试

FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm run smoke

单元测试模拟 API，不需要凭据：

npm test

认证

从已登录的浏览器中复制 Watchlist 的 session cookie（DevTools → Application → Cookies）。将密钥和会话令牌保存在 MCP 服务器环境中，而不是聊天中。

API

Checkout：

• POST /api/checkout/invoices

• GET /api/checkout/invoices/:id

• 认证：X-Api-Key

Watchlist：

• GET /api/watchlist/wallets

• GET /api/watchlist/exchanges

• GET /api/watchlist/manual-assets

• GET /api/watchlist/fx-rates

• 认证：Cookie: session=...

将付款人引导至 paymentUrl。将 confirmed 和 paid_out_of_band 视为已支付。除非你接受未确认的加密货币付款，否则将 payment_detected 视为待处理。

许可证

MIT