MCP Weather Stdio Server

🚀 シンプルなMCPサーバー

このサンプルプロジェクトは、MCPサーバーを極めて簡単な方法で構築する方法をデモンストレーションすることを目的としています。

• 天気情報の取得：高德オープンプラットフォームが提供する天気情報取得APIを使用してMCPサーバーを実装し、リアルタイムおよび未来の天気情報を取得できます。

✨ 主な機能

天気情報取得機能

このMCPサーバーを使用することで、ユーザーは特定の地域の天気情報を取得できます。以下はその流れです。

上の画像の通り：

• ユーザーが質問：「西安で今日はコートが必要ですか？」
• AIが自動的に天気MCPサーバーを呼び出す必要があるか判断します。
• AIはMCPサーバーの要求に基づき、西安の緯度と経度の情報をMCPサーバーに提供します。
• MCPサーバーは内部で高德が提供する天気情報取得APIを呼び出し、結果をAIに返します。
• AIは天気情報を集約してユーザーに出力します。

📦 インストール

環境準備

MCPサーバーの構築と実行

• Java 17以上のバージョン
• Maven 3.6以上のバージョン
• Spring BootとSpring AIの概念に関する理解
• （オプション）Claude DesktopなどのAIアシスタントツールの使用

MCPクライアントと大規模言語モデル

MCPプロトコルをサポートする任意のAI対話クライアントプログラムが使用可能です。例えば、Cline、Continue、Claude Desktopなどです。この記事ではCherry Studioを使用しています。

Cherry Studio はAI対話クライアントで、国内外の多くの大規模言語モデルプロバイダーをサポートしています。例えば、シリコンフロー、阿里云百錬、OpenAIなどです。各プロバイダーには複数の大規模言語モデルサービスがあり、機能と性能にはそれぞれ違いがあり、無料と有料のオプションがあります。

この記事では、シリコンフローが提供するQwen2.5-7B-Instructモデルを使用しています。まず、シリコンフローのアカウントを登録し、APIキーを申請し、Cherry Studioで設定してください。

注意：Function Call機能をサポートする大規模言語モデル（Cherry Studioで🔧アイコンが付いた大規模言語モデル）を選択してください。例えば、Qwen2.5-7B-Instructです。

高德オープンプラットフォームAPIキー

高德オープンプラットフォームからWeb APIキー(key)を申請してください。

構築と実行

MCPサーバーはSTDIO伝送モードを使用し、通常はクライアントによって自動的に起動されます。サーバーのjarファイルを構築するには、次のコマンドを実行します。

./mvnw clean install -DskipTests

構築が完了すると、プロジェクトディレクトリ内のtarget/mcp-weather-stdio-server-0.0.1-SNAPSHOT.jarファイルが生成されます。

インストールと使用

Cherry Studioで設定 > MCPサーバーを開き、MCPサーバーを追加します。以下の画像を参照してください。

• 名前：任意の名前を入力してください。
• タイプ：STDIO
• コマンド：java
• MCP設定パラメータ（スクリーンショットの設定パラメータのコピーをコピーして貼り付けます）：

  {
    "servers": [
      {
        "id": "mcp-server-id",
        "name": "MCP Server Name",
        "description": "MCP Server Description",
        "type": "stdio",
        "command": "java -jar target/mcp-weather-stdio-server-0.0.1-SNAPSHOT.jar"
      }
    ]
  }
  

💻 使用例

基本的な使用法

Cherry StudioでMCP機能を有効にし、以下の手順に従って操作します。

注意事項

• Function Callをサポートする大規模言語モデルを選択してください。
• すべての依存関係と設定が正しいことを確認してください。
• 構築が完了したら、サーバーを起動してください。