Spring Ai MCP

🚀 Java & Spring MCP

このライブラリは、JavaとSpringフレームワークをModel Context Protocol (MCP) と統合するためのものです。MCPは、言語モデルが外部ツールやデータソースとやり取りできるようにするプロトコルです。

⚠️ 重要注意

このプロジェクトはすでに卒業しました！最新バージョンは 新しいリポジトリ をご覧ください。

🚀 クイックスタート

このライブラリは、JavaとSpringフレームワークをModel Context Protocol (MCP) と統合するためのものです。MCPは、言語モデルが外部ツールやデータソースとやり取りできるようにするプロトコルです。本プロジェクトでは、Java開発ツールキット (SDK) とSpring AIの統合モジュールを提供しています。

📚 ドキュメント

• Java MCP SDK ドキュメント
  • リファレンスドキュメント

📦 インストール

このプロジェクトをMavenプロジェクトに追加するには、pom.xml に以下の依存関係を追加してください。

<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp-core</artifactId>
    <version>{latest_version}</version>
</dependency>

<!-- HTTPクライアントが必要な場合 -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp-http-client-sse</artifactId>
    <version>{latest_version}</version>
</dependency>

<!-- Servletサーバーが必要な場合 -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp-servlet-sse</artifactId>
    <version>{latest_version}</version>
</dependency>

<!-- Spring Web MVCを使用する場合 -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp-webmvc</artifactId>
    <version>{latest_version}</version>
</dependency>

<!-- Spring WebFluxを使用する場合 -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp-webflux</artifactId>
    <version>{latest_version}</version>
</dependency>

Mavenリポジトリを構成するには、settings.xml に以下の内容を追加してください。

<mirror>
    <id>habuma-repo</id>
    <url>https://repo.habuma.dev/maven-snapshot/</url>
    <mirrorOf>*</mirrorOf>
</mirror>

詳細については、依存関係管理 を参照してください。

💻 使用例

spring-ai-examples/model-context-protocol リポジトリでは、以下のMCPの使用例を見ることができます。

• SQLite Simple: LLMがSQLiteデータベースとどのように統合されるかを示します。
• SQLite Chatbot: SQLiteデータベースと対話できる対話型チャットボットを作成します。
• Filesystem: LLMがローカルファイルシステム内のファイルやフォルダとやり取りできるようにします。
• Brave: Brave Searchとの自然言語対話を実装し、インターネット検索機能をサポートします。
• Theme Park API サンプル: Spring AIを使用してMCPサーバーとクライアントを作成し、Theme Park APIツールを統合する方法を示します。
• Http SSE クライアント + WebMvc サーバー: さまざまな機能を持つMCP WebMvcサーバーとHttpClientクライアントを作成して使用する方法を示します。
• WebFlux SSE クライアント + WebFlux サーバー: さまざまな機能を持つMCP WebFluxサーバーとクライアントを作成して使用する方法を示します。
• HttpClient SSE クライアント + Servlet サーバー: さまざまな機能を持つMCP ServletサーバーとHttpClientクライアントを作成して使用する方法を示します。

🔧 技術詳細

プロジェクト構成

コアMCPモジュール

• mcp: MCPプロトコルスタックのJava実装を提供し、コアプロトコルとツールを含みます。

トランスポート層モジュール

• mcp-http-client-sse: HTTPベースのServer-Sent Events (SSE) クライアントの実装です。
• mcp-servlet-sse: ServletベースのSSEサーバーの実装です。
• mcp-webmvc: MCPサーバーを作成するためのSpring Web MVC統合モジュールです。
• mcp-webflux: MCPサーバーを作成するためのSpring WebFlux統合モジュールです。

Spring AI統合モジュール

• spring-ai-mcp: Spring AIのMCP統合モジュールです。

ソースコードからのビルド

mvn clean install

テストの実行

mvn test

🤝 貢献

これは実験的なSpringプロジェクトです。皆様の貢献を歓迎します！コードを提出するには、以下の手順に従ってください。

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. プルリクエストを送信する

⚠️ 重要注意

このプロジェクトはまだ初期段階であり、不安定性がある可能性があります。使用する前に、ドキュメントをよく読み、テストを行ってください。