Donts MCP Server Demo

🚀 MCP サーバーデモプロジェクト

このプロジェクトは、Spring BootをベースとしたModel Context Protocol (MCP) サーバーのデモです。電卓、天気検索、データモデルおよびAPIインターフェースツールの機能を提供します。

✨ 主な機能

このプロジェクトは、Spring BootとWebFluxを使用して構築されたシンプルなMCPサーバーの実装で、以下の機能を提供します。

1. 電卓ツール - 数学式を計算できます。
2. 天気検索ツール - 指定した都市のリアルタイムの天気を検索できます。
3. システム情報リソース - システムの基本情報を提供します。
4. データモデル検索ツール - ユーザーの記述に基づいて一致するデータモデルを検索します。
5. APIインターフェース検索ツール - データモデルに基づいて対応するAPIインターフェースを検索します。
6. API実行ツール - ユーザーの入力に基づいてパラメータを構築し、実際のインターフェースを呼び出します。

🔧 技術詳細

• Java 17
• Spring Boot
• Spring WebFlux
• Model Context Protocol (MCP)
• Server-Sent Events (SSE)

🚀 クイックスタート

前提条件

• JDK 17 以上
• Maven 3.6 以上
• 和风天気APIキー（天気検索機能に必要）

設定

1. プロジェクトをローカルにクローンします。
2. src/main/resources/application.yml で和风天気APIキーを設定します。

ビルドと実行

# プロジェクトをコンパイルする
mvn clean package

# プロジェクトを実行する
java -jar target/donts-ai-0.0.1-SNAPSHOT.jar

📚 ドキュメント

APIエンドポイント

SSE接続

• エンドポイント: /sse
• メソッド: GET
• 説明: サーバーからのイベントを受信するためのSSE接続を確立します。

メッセージ送信

• エンドポイント: /mcp/messages
• メソッド: POST
• 説明: メッセージをMCPサーバーに送信します。

ツール機能

電卓ツール

電卓ツールは、以下を含むさまざまな数学式を処理できます。

• 基本演算（加減乗除）
• 複雑な式の計算

例:

2 + 2
(3 * 4) / 2
sqrt(16) + 5

天気検索ツール

天気検索ツールは、指定した都市の天気情報をリアルタイムで取得できます。

システム情報リソース

システム情報リソースは、以下の基本情報を提供します。

• オペレーティングシステムのバージョン
• Javaランタイム環境のバージョン
• アプリケーションの実行時間
• 現在のユーザー情報

データモデル検索ツール

データモデル検索ツールは、ユーザーの記述やキーワードに基づいて一致するデータモデルを検索します。

例の入力:

{
  "description": "用于预测股票价格",
  "keywords": ["时间序列", "回归"]
}

APIインターフェース検索ツール

APIインターフェース検索ツールは、データモデルの名前や機能に基づいて対応するAPIインターフェースの情報を検索します。

例の入力:

{
  "model_name": "用户行为分析模型"
}

API実行ツール

API実行ツールは、ユーザーのリクエストパラメータに基づいてリクエストを構築し、対応するAPIインターフェースを呼び出します。

例の入力:

{
  "url": "http://example.com/api",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "name": "test",
    "value": "123"
  }
}

模擬データケース

ユーザーモデル

{
  "model_name": "用户行为分析模型",
  "description": "用于分析用户的点击流数据",
  "version": "1.0.0"
}

注文モデル

{
  "model_name": "订单预测模型",
  "description": "用于预测未来的订单量",
  "version": "2.1.0"
}

システムアーキテクチャ

このプロジェクトの主なコンポーネントは次のとおりです。

• MCPサーバー - クライアントのリクエストとレスポンスを処理します。
• ツール実装 - 電卓、天気検索、データモデル検索などの機能モジュールが含まれます。
• APIインターフェース - RESTful APIサービスを提供し、SSEイベントのプッシュをサポートします。

🤝 貢献ガイド

プロジェクトへの貢献を歓迎します！以下の手順に従ってください。

1. このリポジトリをフォークします。
2. あなたの機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを開きます。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。