Mifos X - AI - Apache Fineract® 向けモデルコンテキストプロトコル (MCP)

このプロジェクトは、Apache Fineract APIと連携するためのモデルコンテキストプロトコル（MCP）サーバーを提供し、AIエージェントが金融データや金融業務にアクセスできるようにします。実装はPython 、 Java（Quarkus） 、 Node.jsで利用可能です。

MCP 開発者ツール

MCP Inspectorを使用してサーバーをテストおよびデバッグします。

npx @modelcontextprotocol/inspector

これにより、STDIO または SSE 経由で MCP サーバーに接続するためのローカル Web UI が起動します。

Related MCP server: poke-bank

はじめる

1. 実装を選択する

Python（Flask）

前提条件: Python 3.8+、 flask 、 mcp.server.fastmcp

手順:

1. 依存関係をインストールします:

   pip install mcp[cli] uv flask

   zsh ユーザーへの注意: zsh を使用している場合は、シェル拡張エラーを回避するために、必ず extras を引用符で囲んでください。

   pip install 'mcp[cli]' uv flask

2. サーバーを実行します。

   mcp dev app.py

Java（Quarkus）

前提条件: 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) の場合、ネイティブ実行可能ファイルを作成します。

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

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 アクセス

• STDIO/SSEトランスポートを備えたMCP準拠

• 環境に依存しない構成