MCP Server Demo Kut

🚀 MCP サーバーデモプロジェクトドキュメント

このプロジェクトは、Spring Boot 3.4.4 をベースにした MCP（モデル制御プロトコル）サービスのサンプルプロジェクトです。Spring AI ツールチェーンを統合し、インテリジェントサービス機能を実現しています。基礎的な数値演算や天気情報の取得などのサービスの実装テンプレートを含んでいます。

✨ 主な機能

1. 数字サービス（NumberService）

• 奇数偶数の判定
• 素数の検出（実装済み）
• 拡張提案：素因数分解やフィボナッチ数列の計算などの機能を追加することができます。

2. 天気サービス（WeatherService）

• 天気データのインターフェース（現在は乱数を使用した疑似コードです。実際のアプリケーションでは、OpenWeatherMap API などのサードパーティ API と接続する必要があります）

3. MCP ツールサポート

• @Tool アノテーションを使用して、サービスを標準化されたツールとして公開します。
• @ToolParam アノテーションを使用して、サービスのパラメータを定義します。

📚 ドキュメント

プロジェクト構成

src
|-- main
|  |-- java
|  |  `-- cn
|  |    `-- liqingdong
|  |      `-- mcp
|  |        `-- server
|  |          |-- McpApplication.java
|  |          `-- service
|  |            |-- NumberService.java
|  |            `-- WeatherService.java
|  `-- resources
|    `-- application.yml
`-- test
  `-- java
    `-- cn
      `-- liqingdong
        `-- mcp
          `-- server
            |-- McpApplicationTest.java
            `-- SSEMcpTest.java
            `-- STDIOMcpTest.java

🚀 クイックスタート

環境要件

• JDK 17
• Maven 3.8 以上
• IDE（IntelliJ IDEA を推奨）

実行手順

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

git clone https://github.com/liqingdong/mcp-server-demo.git 

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

mvn clean install

3. サービスを使用する

3.1 STDIO モードを使用する

3.1.1 起動コマンドを設定する

java -jar -Dspring.ai.mcp.server.stdio=true target/mcp-server-demo-0.0.1-SNAPSHOT.jar

3.1.2 MCP ツールをサポートするクライアント（例：Cherry Studio）を使用してテストする

3.2 SSE モードを使用する

3.2.1 起動コマンドを設定する（デフォルトのアクセスアドレスは：http://localhost:8081/sse）

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

主要なテストクラス

🔧 技術詳細

開発規約

1. コードスタイル：統一されたコーディング規約に従います。
2. アノテーションの使用：@Tool と @ToolParam アノテーションを使用して、サービスを公開し、パラメータを定義します。
3. テストカバレッジ：主要な機能が十分にテストされるようにします。

貢献ガイド

1. コードの提出：Fork したプロジェクトから Pull Request を提出してください。
2. 問題の報告：Issues で問題や改善提案を報告してください。

📄 ライセンス

• Spring Boot バージョン：3.4.4
• JDK バージョン：17 以上
• オープンソースライセンス：MIT License

![ Shields アイコンの位置 ]