Mifosx

🚀 Apache Fineract API MCP 服務器項目

本項目為 Apache Fineract API 打造了 Model Context Protocol (MCP) 服務器，助力 AI 代理訪問財務數據並進行操作。項目提供了 Python、Java (Quarkus) 和 Node.js 三種語言的實現方案。

🚀 快速開始

選擇實現方式

Python (Flask)

先決條件：需要 Python 3.8 及以上版本，以及 flask、mcp.server.fastmcp 庫。 步驟：

1. 安裝依賴項：

   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
   

✨ 主要特性

• 標準化 API 訪問：通過 fineract:// URI 實現。
• 符合 MCP 標準：支持 STDIO/SSE 傳輸。
• 環境無關性：配置靈活。

📦 安裝指南

MCP 開發工具

使用 MCP 檢查器 測試和調試你的服務器：

npx @modelcontextprotocol/inspector

這會啟動一個本地 Web UI，通過 STDIO 或 SSE 連接到你的 MCP 服務器。

💻 使用示例

基礎用法

使用 MCP 檢查器進行測試

1. 啟動你的 MCP 服務器（Python/Java/Node.js）。
2. 運行檢查器：

   npx @modelcontextprotocol/inspector
   

3. 使用 STDIO 傳輸連接到服務器。

📚 詳細文檔

配置

所有實現都需要以下環境變量：

注意：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)，創建一個原生可執行文件：

./mvnw package -Dnative -Dquarkus.native.container-build=true
./target/mcp-server-1.0.0-SNAPSHOT-runner

貢獻指南

• Python：修改 python/app.py 配置 .env 文件路徑。
• Java：在 src/main/java/org/mifos-community/ai/MCPServer.java 中配置環境變量。
• Node.js：編輯 config.js 設置服務器參數。