mcp-mifosx

Mifos X - AI - Протокол контекста модели (MCP) для Apache Fineract®

Этот проект предоставляет серверы Model Context Protocol (MCP) для взаимодействия с Apache Fineract API, позволяя агентам ИИ получать доступ к финансовым данным и операциям. Реализации доступны на Python , Java (Quarkus) и Node.js .

Инструменты разработчика MCP

Используйте MCP Inspector для тестирования и отладки вашего сервера:

Это запустит локальный веб-интерфейс для подключения к вашему серверу MCP через STDIO или SSE.

Начиная

1. Выберите вариант реализации

Питон (Flask)

Предварительные требования : Python 3.8+, flask , mcp.server.fastmcp

Шаги :

1. Установить зависимости:
   pip install mcp[cli] uv flask

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

   pip install 'mcp[cli]' uv flask

2. Запускаем сервер:
   mcp dev app.py

Java (Кваркус)

Предварительные требования : JDK 17+, Maven

Шаги :

1. Настройте переменные среды в вашей оболочке или IDE:
   export MIFOSX_BASE_URL="https://your-fineract-instance" export MIFOSX_BASIC_AUTH_TOKEN="your_api_token" export MIFOS_TENANT_ID="default"
2. Запустить через JBang (для быстрого выполнения):
   jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
3. (Необязательно) Создайте собственный исполняемый файл:
   ./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner

Node.js

Предварительные требования : Node.js 16+, npm

Шаги :

1. Установить зависимости:
   cd nodejs && npm install
2. Настройте переменные среды в .env :
   cp .env.example .env
3. Запустите сервер:
   npm run dev
4. Протестируйте с помощью встроенного скрипта inspect :
   npm run inspect

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

Для всех реализаций требуются следующие переменные среды:

Примечание : Java использует переменные с префиксом MIFOSX_ (например, MIFOSX_BASE_URL ).

Доступные ресурсы

Сервер MCP предоставляет следующие ресурсы:

Основные ресурсы

• fineract://clients
  Список всех клиентов
• fineract://clients/{clientId}
  Получить данные по конкретному клиенту
• fineract://loans
  Список всех кредитов
• fineract://loans/{loanId}
  Получить подробную информацию по конкретному кредиту

Инструменты

• search_clients
  Поиск клиентов по имени/атрибутам
• create_client
  Создать нового клиента (только Node.js/Python)
• update_loan_status
  Обновить статус кредита (только Java/Python)

Создание собственных исполняемых файлов (только Java)

Для Java (Quarkus) создайте собственный исполняемый файл:

Тестирование с помощью MCP Inspector

1. Запустите свой MCP-сервер (Python/Java/Node.js).
2. Запустите инспектор:
   npx @modelcontextprotocol/inspector
3. Подключитесь к серверу, используя транспорт STDIO .

Внося вклад

• Python : измените python/app.py и server.js для новых ресурсов.
• Java : Расширить src/main/java/org/mifos/community/ai/... для новых конечных точек.
• Node.js : обновите nodejs/src/server.js и добавьте схемы Zod для проверки.

Контакт

• Сообщество Apache Fineract: https://community.apache.org/
• Спецификация MCP: https://modelcontextprotocol.org

Руководства

• Java/Quarkus : Руководство по Quarkus MCP
• Node.js : используйте npm run inspect для перезагрузки в реальном времени
• Python : Запустите с помощью python app.py и настройте .env

Основные характеристики:

• Стандартизированный доступ к API через URI fineract://
• Совместимость с MCP и транспортами STDIO/SSE
• Конфигурация , не зависящая от среды