Sprint Boot Sample MCP Server

🚀 モデルコンテキストプロトコル（MCP）サーバーのSpring Bootによる実装例

このプロジェクトは、Spring Bootを使用したモデルコンテキストプロトコル（MCP）サーバーの実装例です。このサーバーは、MCPインスペクターと連携してテストやデバッグを行うことを目的として設計されています。簡単なREST APIを提供してサーバーとのやり取りを可能にし、基本的なSpring Bootアプリケーションのセットアップ方法を示しています。また、サーバーの機能を検証するための単体テストも含まれています。

🚀 クイックスタート

このMCPサーバーを使用するには、以下の手順に従ってください。

1. リポジトリをクローンする

git clone https://github.com/your-repository.git
cd mcp-server

2. プロジェクトをビルドする

以下のコマンドを実行してプロジェクトをビルドします。

mvn clean install

3. サーバーを起動する

ビルドが完了したら、以下のコマンドを実行してサーバーを起動します。

java -jar target/mcp-server-0.0.1-SNAPSHOT.jar

4. APIをテストする

curlやその他のツールを使用してREST APIをテストします。例えば：

curl http://localhost:8080/api/test

✨ 主な機能

• MCPサーバーの実装：Spring Bootを使用してMCPサーバーを実装し、MCPインスペクターと連携してテストやデバッグを行うことができます。
• REST APIの提供：簡単なREST APIを提供してサーバーとのやり取りを可能にします。
• 単体テストの実装：サーバーの機能を検証するための単体テストが含まれています。

📦 インストール

必要条件

• Java 17以上のバージョン
• Maven
• MCPインスペクター（テスト用、オプション）

例：Claudeデスクトップの設定

{
  "mcpServers": {
    "sample-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "sample-mcp-server-0.0.1-SNAPSHOT.jar",
        "--port",
        "8080",
        "--host",
        "localhost"
      ],
      "env": {
        "JAVA_TOOL_OPTIONS": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"
      }
    }
  }
}

注意：JAVA_TOOL_OPTIONS環境変数は、リモートデバッグ用のJVMオプションを設定するために使用されます。アドレスとポートは必要に応じて変更できます。

💻 使用例

デバッグ

MCPインスペクターをインストールする

npm -g install @modelcontextprotocol/inspector

MCPインスペクターを実行してテストする

MCPサーバーをビルドする

mvn clean package

MCPインスペクターを実行する

npx @modelcontextprotocol/inspector -- sample-mcp-server.json

📚 ドキュメント

🧠 何がMCP？

モデルコンテキストプロトコル（MCP）は、AIモデルが外部ツールやデータソースと通信する方法を定義するオープン標準です。ClaudeなどのAIアシスタントが以下の内容にアクセスするための標準的な方法を提供します。

• 🌐 リアルタイム情報
• 📊 カスタムデータベース
• 🔄 APIとサービス
• 📁 ファイルシステム

MCPを「AIのUSB標準」のようなものと考えてください。これは、あらゆるAIモデルが一貫したプロトコルを通じてさまざまなツールとやり取りできる汎用インターフェースを提供します。

Spring Bootを使用するメリット：

• 🔄 シームレスな統合：アプリケーションの機能をAIアシスタントに簡単に公開できます。
• 🛠️ ツール定義：簡単なアノテーションを使用してカスタムツールを定義できます。
• 🚀 Spring Bootの簡便性：Springの依存性注入と構成管理を利用できます。
• 📈 強化されたAI機能：AIモデルが組織のリアルタイムデータとサービスにアクセスできるようになります。

参考資料

Spring AI 延伸了 MCP Java SDK 的功能