Spring MCP Server

🚀 Spring MCP サーバー

モデルコンテキストプロトコル（Model Context Protocol）は、開発者が自身のデータソースとAIツール間に安全な双方向接続を構築できるようにするオープン標準です。このアーキテクチャはシンプルで、開発者は自らのデータをMCPサーバーを通じて公開することも、AIアプリケーション（MCPクライアント）を構築してこれらのサーバーに接続することもできます。

✨ 主な機能

• モデルコンテキストプロトコルを利用して、データソースとAIツール間の安全な双方向接続を可能にします。
• 開発者は自身のデータをMCPサーバーを通じて公開でき、またAIアプリケーションを構築してこれらのサーバーに接続できます。

📦 インストール

前提条件

• Java 21
• Maven 3.9.9
• Spring Boot 3.4.4
• Spring AI 0.4.0
• Spring Model Context Protocol Server
• Claude Desktop Application

🚀 クイックスタート

この例では、MCPサーバーとして機能する簡単なSpring Bootアプリケーションを作成します。

1. Spring Bootアプリケーションの作成

Spring Initializrまたはその他の好みの方法を使用して、新しいSpring Bootアプリケーションを作成してください。以下の依存関係を含めるようにしてください。

• Spring Model Context Protocol Server

レコードクラスの作成

MCPサーバーを介して公開する情報を表すレコードクラスを作成します。

package org.sehn.spring_mcp;

public record Info(String title, String url) {
}

サービスクラスの作成

MCPサーバーで公開する情報を提供するサービスクラスを作成します。

package org.sehn.spring_mcp;

import jakarta.annotation.PostConstruct;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.stereotype.Service;

import java.util.ArrayList;
import java.util.List;

@Service
public class InfoService {

    private static final Logger logger = LoggerFactory.getLogger(InfoService.class);

    private List<Info> information = new ArrayList<>();

    @Tool(name = "dr_get_information", description = "Get a list of information about Deepanshu Rawat")
    public List<Info> getInformation() {
        return information;
    }

    @Tool(name = "dr_get_info", description = "Get a specific information about Deepanshu Rawat")
    public Info getInfo(String title) {
        return information.stream().filter(info -> info.title().equals(title)).findFirst().orElse(null);
    }

    @PostConstruct
    public void init() {
        information.addAll(List.of(
                new Info("Portfolio", "https://bento.me/deepanshu-rawat6"),
                new Info("GitHub", "https://github.com/deepanshu-rawat6"),
                new Info("LinkedIn", "https://www.linkedin.com/in/deepanshu-rawat6/"),
                new Info("Twitter", "https://twitter.com/deepanshuurawat")
        ));


    }
}

ツールコールバックの作成

SpringMCPApplicationまたはメインアプリケーションクラスで、MCPサーバーのリクエストを処理するツールコールバックを作成します。

    @Bean
    public List<ToolCallback> deepanshuTools(InfoService infoService) {
        return List.of(ToolCallbacks.from(infoService));
    }

設定の追加

MCPサーバーを構成する設定クラスを作成します。

spring.application.name=spring_mcp
spring.main.web-application-type=none
spring.ai.mcp.server.name=spring_mcp
spring.ai.mcp.server.version=0.0.1


spring.main.banner-mode=off
logging.pattern.console=

2. アプリケーションのビルド

以下のコマンドを実行してアプリケーションをビルドします。

mvn clean package -DskipTests

3. さらなる設定

MCPサーバーを使用するには、claude_desktop_config.jsonに以下の設定を追加する必要があります。

{
    "spring": {
        "application": {
            "name": "spring_mcp"
        },
        "main": {
            "web-application-type": "none"
        },
        "ai": {
            "mcp": {
                "server": {
                    "name": "spring_mcp",
                    "version": "0.0.1"
                }
            }
        }
    },
    "logging": {
        "pattern": {
            "console": ""
        }
    }
}

4. MCPサーバーのテスト

設定が完了したら、Claude DesktopでMCPサーバーをテストできます。config.jsonファイルに以下の内容を追加します。

{
    "servers": [
        {
            "url": "http://localhost:8080",
            "name": "spring_mcp"
        }
    ]
}

サーバーを起動すると、Claude Desktopで使用できます。

📚 ドキュメント

画像説明

• 図1: Claude DesktopでMCPサーバーを構成する方法を示しています。
• 図2: MCPサーバーをテストする方法を示しています。