Spring MCP Bridge

🚀 Spring MCP ブリッジツール

Spring MCP ブリッジツール は、Spring Boot アプリケーション内の REST エンドポイントを自動的に MCP（メッセージ対話プロトコル）サーバーに変換するツールです。これにより、Claude や Cursor などの MCP 互換ツールが直接あなたの API とやり取りできるようになります。

現在のバージョンには認証機能が含まれていません。認証が必要な Spring Boot API を使用する場合は、処理コードに適切なヘッダー情報またはトークンを追加してください

📚 概要

既存の API を AI アシスタントに統合するには、通常、手動でのコーディングや複雑な設定が必要です。Spring MCP ブリッジツールは、あなたの Spring Boot プロジェクトを自動的にスキャンし、すぐに使える MCP サーバーを生成することで、この複雑さを解消します。

✨ 主な機能

• 自動スキャン：すべての REST エンドポイント（@RestController、@GetMapping など）を検出します。
• ゼロコンフィグ：既存の Spring Boot コードに何ら変更を加える必要がありません。
• モデル保持：リクエストとレスポンスのモデルを MCP ツールと互換性を持たせたまま維持します。
• Javadoc 抽出：既存のドキュメントを利用して MCP ツールの説明を強化します。
• 完全なドキュメント：README と明確な使用説明を生成します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/brunosantos/spring-mcp-bridge.git

# ディレクトリに移動する
cd spring-mcp-bridge

💻 使用例

基本的な使用法

1. Spring Boot プロジェクトをスキャンする：

python spring_boot_mcp_converter.py --project /path/to/spring-project --output ./mcp_server --name MyAPI

2. 生成された MCP サーバーを実行する：

cd mcp_server
pip install -r requirements.txt
python main.py

3. MCP クライアントで接続する：
   • あなたの MCP クライアント（Claude、Cursor など）を http://localhost:8000 を使用するように設定します。
   • MCP モードの説明は http://localhost:8000/.well-known/mcp-schema.json で利用可能です。

📋 パラメータ

高度な使用法

プロジェクトの作成

# 新しいプロジェクトを初期化する
mkdir my_mcp_project
cd my_mcp_project
python -m spring_mcp_bridge init

サーバーの実行

# 依存関係をインストールする
pip install -r requirements.txt

# サーバーを起動する
python main.py

🔧 設定説明

プロジェクト設定

config.py ファイルで、以下の設定をカスタマイズできます。

# ログレベルを設定する
LOG_LEVEL = "DEBUG"

# 最大スレッド数を設定する
MAX_THREADS = 10

環境変数

環境変数を使用して、ブリッジツールをさらに設定できます。

export MCP_BRIDGE_ENV=development
export MCP_BRIDGE_PORT=8000

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

🙏 謝辞

• FastAPI - MCP と MCP ツールエコシステムからインスピレーションを得ています。
• Spring Boot と FastAPI コミュニティに感謝します。

📋 注意事項

⚠️ 重要提示

現在のバージョンには認証機能が含まれていません。認証が必要な Spring Boot API を使用する場合は、処理コードに適切なヘッダー情報またはトークンを追加してください。