Mifos X - AI - Apache Fineract® 向けモデルコンテキストプロトコル (MCP)
このプロジェクトは、Apache Fineract APIと連携するためのモデルコンテキストプロトコル（MCP）サーバーを提供し、AIエージェントが金融データや金融業務にアクセスできるようにします。実装はPython 、 Java（Quarkus） 、 Node.jsで利用可能です。
MCP 開発者ツール
MCP Inspectorを使用してサーバーをテストおよびデバッグします。
これにより、STDIO または SSE 経由で MCP サーバーに接続するためのローカル Web UI が起動します。
Related MCP server: Xero MCP Server
はじめる
1. 実装を選択する
Python（Flask）
前提条件: Python 3.8+、 flask 、 mcp.server.fastmcp
手順:
依存関係をインストールします:
pip install mcp[cli] uv flaskzsh ユーザーへの注意: zsh を使用している場合は、シェル拡張エラーを回避するために、必ず extras を引用符で囲んでください。
pip install 'mcp[cli]' uv flaskサーバーを実行します。
mcp dev app.py
Java（Quarkus）
前提条件: JDK 17+、Maven
手順:
シェルまたは IDE で環境変数を設定します。
export MIFOSX_BASE_URL="https://your-fineract-instance" export MIFOSX_BASIC_AUTH_TOKEN="your_api_token" export MIFOS_TENANT_ID="default"JBang 経由で実行 (クイック実行の場合):
jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner(オプション) ネイティブ実行可能ファイルをビルドします。
./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner
Node.js
前提条件: Node.js 16以上、npm
手順:
依存関係をインストールします:
cd nodejs && npm install.envで環境変数を設定します。cp .env.example .envサーバーを実行します。
npm run dev組み込みの
inspectスクリプトでテストします。npm run inspect
構成
すべての実装には次の環境変数が必要です。
変数 | 説明 |
| Fineract インスタンスのベース URL |
| API認証トークン |
| テナント識別子（デフォルト：
） |
注意: 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によるテスト
MCP サーバー (Python/Java/Node.js) を起動します。
インスペクターを実行します:
npx @modelcontextprotocol/inspectorSTDIOトランスポートを使用してサーバーに接続します。
貢献
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 アクセスSTDIO/SSEトランスポートを備えたMCP準拠
環境に依存しない構成