xendit-mcp (只读)

用于 Xendit 的极简只读 MCP 服务器。专为 CareNow 问题解决代理构建 — 用于查找付款、支出、退款和虚拟账户 (VA) 交易。绝不进行资金转移。

非官方项目。未与 Xendit 关联或受其认可。

为什么选择只读？

代理不应能够调用 create_disbursement、create_refund 或 expire_invoice — 即使是通过 Xendit 端字段的提示注入也不行。此服务器仅公开 GET 端点。为了实现深度防御，请同时使用权限范围限定为 *_READ 的 Xendit API 密钥。

安装与运行

无需克隆。通过 npx 直接从 GitHub 安装：

{
  "mcpServers": {
    "xendit": {
      "command": "npx",
      "args": ["-y", "github:indratjhai/xendit-mcp"],
      "env": {
        "XENDIT_API_KEY": "xnd_development_..."
      }
    }
  }
}

首次运行时，npm 会克隆仓库、安装依赖项，并通过 prepare 脚本运行 npm run build。之后它将从缓存的安装中启动。

锁定特定提交以实现可重复性：

"args": ["-y", "github:indratjhai/xendit-mcp#<commit-sha>"]

本地开发

git clone https://github.com/indratjhai/xendit-mcp.git
cd xendit-mcp
npm install
cp .env.example .env  # fill in XENDIT_API_KEY
npm run dev

API 密钥

1. 前往 https://dashboard.xendit.co/settings/developers#api-keys

2. 创建一个具有只读权限的密钥：

   • BALANCE_READ

   • INVOICE_READ

   • TRANSACTION_READ

   • DISBURSEMENT_READ

   • REFUND_READ

   • PAYMENT_REQUEST_READ

3. 开发时请使用 xnd_development_... 测试密钥。

工具

不包含的功能（设计使然）

• create_invoice、expire_invoice

• create_disbursement

• create_refund

• create_payment_request

• 任何 POST / PATCH / DELETE 操作

如果工作流需要进行变更操作，应在 Xendit 仪表板中手动完成，或通过人工审核的独立审批流程完成 — 而不是通过代理会话。

安全说明

• API 密钥从 XENDIT_API_KEY 环境变量中读取。绝不记录，绝不发送到工具输出。

• 网络出口硬编码为 https://api.xendit.co — 不允许访问其他主机。

• 路径组件 ID 经过 ^[a-zA-Z0-9_-]+$ 验证并进行 URL 编码。

• 所有工具输入均经过 zod 验证。

• 仅有的运行时依赖：@modelcontextprotocol/sdk、zod。

许可证

MIT