Сервер Payman AI MCP

Сервер 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-совместимым клиентом.

Функции

Безопасная аутентификация 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

Клонируйте репозиторий:
git clone https://github.com/yourusername/payman-mcp-server.git cd payman-mcp-server
Установите зависимости:
npm install # OR yarn install
Создайте код 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

Клод Десктоп

Откройте файл конфигурации Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Добавьте конфигурацию сервера:
{ "mcpServers": { "payman": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/payman-mcp-server/build/payman-server.js"] } } }
Перезагрузить рабочий стол Клода

Другие клиенты 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 для проверки входных данных

Payman AI MCP Server