Mifosx

🚀 Apache Fineract API MCP サーバー

このプロジェクトは、Apache Fineract API 用の Model Context Protocol (MCP) サーバーを提供し、AI エージェントが財務データにアクセスして操作できるようにします。Python、Java (Quarkus)、Node.js の実装が用意されています。

🚀 クイックスタート

MCP 開発ツール

MCP インスペクター を使用してサーバーをテストおよびデバッグできます。

npx @modelcontextprotocol/inspector

これにより、ローカルの Web UI が起動し、STDIO または SSE を介して MCP サーバーに接続します。

実装方法の選択

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. シェルまたは 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 サーバーを起動し、AI エージェントが財務データにアクセスできるようにします。

高度な使用法

Java でネイティブ実行ファイルをビルドする場合、以下のコマンドを使用します。

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

📚 ドキュメント

利用可能なリソース

MCP サーバーは、以下のリソースを公開しています。

コアリソース

• fineract://clients
  すべてのクライアントをリストします。
• fineract://clients/{clientId}
  特定のクライアントの詳細情報を取得します。
• fineract://loans
  すべてのローンをリストします。
• fineract://loans/{loanId}
  特定のローンの詳細情報を取得します。

ツール

• search_clients
  クライアントを検索します（名前/属性で）。
• create_client
  新しいクライアントを作成します（Node.js/Python のみ）。
• update_loan_status
  ローンのステータスを更新します（Java/Python のみ）。

MCP インスペクターを使用したテスト

1. MCP サーバー（Python/Java/Node.js）を起動します。
2. インスペクターを実行します。

   npx @modelcontextprotocol/inspector
   

3. STDIO トランスポートを使用してサーバーに接続します。

貢献ガイド

• Python：python/app.py を編集し、.env ファイルのパスを設定します。
• Java：src/main/java/org/mifos-community/ai/MCPServer.java で環境変数を設定します。
• Node.js：config.js を編集してサーバーパラメータを設定します。

✨ 主な機能

• 標準化された API アクセス fineract:// URI を通じて
• MCP 標準準拠 STDIO/SSE トランスポートをサポート
• 環境非依存性 柔軟な構成