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

• Конфигурация , не зависящая от среды