mcp-mifosx

Mifos X - AI - Apache Fineract® 的模型上下文协议 (MCP)

该项目提供模型上下文协议 (MCP) 服务器，用于与 Apache Fineract API 交互，使 AI 代理能够访问财务数据和操作。目前已提供Python 、 Java (Quarkus)和Node.js 等语言的实现。

MCP 开发工具

使用MCP 检查器测试和调试您的服务器：

这将启动本地 Web UI 以通过 STDIO 或 SSE 连接到您的 MCP 服务器。

入门

1. 选择您的实施方案

Python（Flask）

先决条件：Python 3.8+、 flask 、 mcp.server.fastmcp

步骤：

1. 安装依赖项：
   pip install mcp[cli] uv flask

   zsh 用户请注意：如果您使用 zsh，请务必引用 extras 以避免 shell 扩展错误：

   pip install 'mcp[cli]' uv flask

2. 运行服务器：
   mcp dev app.py

Java（Quarkus）

先决条件：JDK 17+，Maven

步骤：

1. 在您的 shell 或 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

主要特点：

• 通过fineract:// URI实现标准化 API 访问
• 符合 MCP 标准的 STDIO/SSE 传输
• 与环境无关的配置