Сервер MCP API Payman

Сервер MCP (Model Context Protocol), который обеспечивает бесшовную интеграцию с платежными API Payman AI, позволяя помощникам на базе ИИ создавать получателей платежей, искать существующих получателей платежей, отправлять платежи и проверять балансы с помощью естественного языка.

Обзор

Этот сервер MCP раскрывает платежную функциональность Payman AI как инструменты, которые могут использоваться приложениями LLM, такими как Claude. Он позволяет помощникам AI выполнять следующие операции:

• Установите ключи API для аутентификации

• Создайте различные типы получателей платежей (TEST_RAILS, US_ACH, CRYPTO_ADDRESS)

• Отправляйте платежи зарегистрированным получателям

• Поиск получателей платежей по различным критериям

• Проверить остатки на счетах

Данная реализация соответствует стандарту Model Context Protocol (MCP), обеспечивая совместимость с любым MCP-совместимым клиентом.

Related MCP server: Monei MCP Server

Функции

• Безопасная аутентификация API : безопасное управление ключами API в рамках сеанса

• Несколько типов получателей платежей :

  • Получатели TEST_RAILS за тестирование

  • Получатели платежей US_ACH для банковских переводов в США

  • CRYPTO_ADDRESS получатели платежей за криптовалютные транзакции

• Платежные операции :

  • Отправляйте платежи с указанием индивидуальных сумм и примечаний

  • Получить текущие остатки

• Возможности поиска :

  • Поиск получателей платежей по имени, контактной информации, реквизитам счета и т. д.

• Обработка ошибок : комплексная обработка ошибок для всех операций API.

• Безопасные транспорты : поддерживаются транспорты stdio и SSE (Server-Sent Events)

Предпосылки

• Node.js (v14 или выше)

• npm или пряжа

• API-ключ Payman AI

Установка

Установка через Smithery

Чтобы автоматически установить payman_mcp для Claude Desktop через Smithery :

npx -y @smithery/cli install @hrishi0102/payman_mcp --client claude

1. Клонируйте репозиторий:

   git clone https://github.com/yourusername/payman-mcp-server.git
   cd payman-mcp-server

2. Установите зависимости:

   npm install
   # OR
   yarn install

3. Создайте код TypeScript:

   npm run build
   # OR
   yarn build

Конфигурация

Серверу не требуются никакие файлы конфигурации. Ключи API устанавливаются во время выполнения с помощью инструмента set-api-key .

Запуск сервера

Стандартный режим ввода-вывода (для Claude Desktop и т. д.)

Запустите сервер в режиме stdio, который совместим с Claude Desktop и аналогичными клиентами MCP:

Проверьте правильность настройки сервера:

node /ABSOLUTE/PATH/TO/PARENT/FOLDER/payman-mcp/build/payman-server.js

Если все хорошо, теперь вы можете добавить сервер Payman MCP к любому клиенту.

• Для Claude Desktop: Здесь

• Для курсора: Здесь

Режим событий, отправленных сервером (SSE) (для веб-интеграции)

Для запуска сервера с транспортом SSE (требуются дополнительные зависимости: express и cors ):

node build/payman-server-sse.js

Это запустит веб-сервер на порту 3001 со следующими конечными точками:

• /sse — конечная точка SSE для связи между сервером и клиентом.

• /messages — конечная точка для сообщений клиент-сервер.

Интеграция с клиентами MCP

Клод Десктоп

1. Откройте файл конфигурации Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Добавьте конфигурацию сервера:

   {
     "mcpServers": {
       "payman": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/payman-mcp-server/build/payman-server.js"]
       }
     }
   }

3. Перезагрузить рабочий стол Клода

Другие клиенты MCP

Для других клиентов MCP, таких как Cursor, обратитесь к их специальной документации по добавлению серверов MCP.

Руководство по использованию

После подключения сервера к клиенту MCP вы можете использовать следующие инструменты:

Установка ключа API

Сначала вам необходимо установить ключ API Payman:

Please use the set-api-key tool with my Payman API key: YOUR_API_KEY_HERE

Создание получателей платежей

Тестовые рельсы Получатель платежа

Create a test payee named "Test User" with the tag "test"

Получатель платежа ACH США

Create a US ACH payee with these details:
- Name: John Doe
- Account Type: checking
- Account Number: 12345678
- Routing Number: 123456789
- Account Holder Name: John Doe
- Account Holder Type: individual

Получатель криптовалюты

Create a crypto payee with:
- Name: Crypto Wallet
- Address: 0x1234567890abcdef
- Chain: ethereum
- Currency: ETH

Отправка платежей

Send a payment of 100 to payee ID "pay_123abc" with the memo "Monthly service"

Поиск получателей платежей

Search for all payees with the name "John"

Проверка баланса

What's my current balance?

Справочник по инструментам

set-api-key

Устанавливает ключ API Payman для аутентификации.

• Параметры :

  • apiKey (строка): API-ключ Payman

create-test-rails-payee

Создает получателя платежа TEST_RAILS для тестирования.

• Параметры :

  • name (строка): Имя получателя платежа

  • type (строка): "TEST_RAILS" (по умолчанию)

  • tags (string[]): Необязательные теги для получателя платежа

create-us-ach-payee

Создает получателя платежа US_ACH для банковских переводов.

• Параметры :

  • type (строка): "US_ACH" (по умолчанию)

  • accountType (перечисление): «чековый» или «сберегательный»

  • accountNumber (строка): номер банковского счета

  • routingNumber (строка): номер маршрута

  • accountHolderName (строка): Имя владельца счета

  • accountHolderType (перечисление): «индивидуальный» или «бизнес»

  • name (строка): Имя этого получателя платежа

  • Плюс дополнительные необязательные параметры (теги, contactDetails)

create-crypto-payee

Создает получателя CRYPTO_ADDRESS для криптовалютных платежей.

• Параметры :

  • type (строка): "CRYPTO_ADDRESS" (по умолчанию)

  • address (строка): адрес криптовалюты

  • chain (строка): блокчейн для использования

  • currency (строка): Криптовалюта/токен

  • name (строка): Имя этого получателя платежа

  • Плюс дополнительные необязательные параметры (теги, contactDetails)

send-payment

Отправляет платеж получателю.

• Параметры :

  • payeeId (строка): идентификатор получателя платежа

  • amountDecimal (число): Сумма для отправки

  • walletId (строка, необязательно): Конкретный кошелек для использования

  • memo (строка, необязательно): Платежное уведомление

  • metadata (объект, необязательно): Дополнительные метаданные

search-payees

Поиск получателей платежей по различным критериям.

• Параметры : несколько дополнительных параметров поиска

  • name , contactEmail , accountNumber и т. д.

get-balance

Возвращает текущий баланс счета.

• Параметры : Нет

Обработка ошибок

Все инструменты включают надлежащую обработку ошибок и возвращают описательные сообщения об ошибках, если:

• API-ключ не установлен

• API-запросы не выполняются

• Указаны неверные параметры.

• Возникают проблемы с сетью

Соображения безопасности

• API-ключи хранятся в памяти на протяжении всего сеанса.

• Сервер не сохраняет учетные данные на диске.

• Все запросы к API Payman используют соответствующие заголовки авторизации.

• Модель контекстного протокола для спецификации MCP

• Payman AI для платежного API

• Zod для проверки входных данных