xendit-mcp (только для чтения)

Минималистичный MCP-сервер для Xendit с доступом только для чтения. Создан для агента CareNow Issue Resolver — выполняет поиск платежей, выплат, возвратов и транзакций по виртуальным счетам (VA). Никогда не переводит деньги.

Неофициальный проект. Не связан с Xendit и не поддерживается компанией Xendit.

Почему только для чтения?

Агенты не должны иметь возможность вызывать create_disbursement, create_refund или expire_invoice — даже через инъекцию промпта из поля на стороне Xendit. Этот сервер предоставляет только GET-эндпоинты. Для обеспечения эшелонированной защиты также используйте API-ключ Xendit с правами доступа *_READ.

Related MCP server: mcp-sqlserver-readonly

Установка и запуск

Клонирование не требуется. Установите напрямую из GitHub через npx:

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

При первом запуске npm клонирует репозиторий, устанавливает зависимости и выполняет npm run build через скрипт prepare. После этого запуск происходит из кэшированной установки.

Зафиксируйте конкретный коммит для воспроизводимости:

"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. Создайте ключ с правами только для чтения (READ-only):

   • 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 — другие хосты запрещены.

• Идентификаторы в компонентах пути проверяются по регулярному выражению ^[a-zA-Z0-9_-]+$ и кодируются в URL.

• Все входные данные инструментов проверяются с помощью zod.

• Только зависимости времени выполнения: @modelcontextprotocol/sdk, zod.

Лицензия

MIT