mcp-mifosx

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

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

MCP 開発者ツール

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

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

はじめる

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

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準拠
• 環境に依存しない構成