Simple MCP Server C51

🚀 シンプルMCPサーバー

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

✨ 主な機能

• 天気情報の取得：高德開放プラットフォームが提供する天気情報取得APIを利用して、MCPサーバーでの天気情報取得機能を実現しています。リアルタイムの天気情報や未来の天気予報を取得できます。
• 钉钉グループへのメッセージ送信：钉钉グループロボットを通じて、指定した钉钉グループに情報を送信できます。

🎥 機能デモ

ユーザーが「西安で今日はコートが必要ですか」と質問した場合：

1. AIは自動的にMCPサーバーを呼び出す必要があるかどうかを判断します。
2. AIはMCPサーバーの要求に基づいて、西安の経度と緯度の情報を提供します。
3. MCPサーバーは内部で高德の天気情報取得APIを使用して天気データを取得し、その結果をAIに返します。
4. AIは天気情報を整理した後、ユーザーに送信します。

同時に、AIは天気情報を钉钉グループロボットを通じて钉钉グループに送信することもできます。下図のような結果が得られます。

📦 インストール

環境設定

MCPサーバーの構築と実行

• Node.js 22+：最新バージョンのNode.jsがインストールされていることを確認してください。
• Pnpm：依存関係の管理にPnpmを使用します。

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

MCPプロトコルをサポートするAI対話クライアントを使用することをおすすめします。例えば、Cherry Studioです。この記事のサンプルでは、硅基流动が提供するQwen2.5 - 7B - Instructモデルを使用します。硅基流动で登録し、APIキーを取得し、Cherry Studioで設定する必要があります。

⚠️ 重要な注意事項

Function Call機能を持つ大規模言語モデルを選択してください。これらのモデルは通常（例：🔧）とマークされています。

構築手順

1. プロジェクトのコードをローカルパス（例：/Users/yourname/simple - mcp - server/）にクローンします。
2. ターミナルを開き、そのディレクトリに移動します。
3. 依存関係をインストールするために、コマンド pnpm i を実行します。
4. サーバーを構築するために、コマンド pnpm build を実行します。

構築が完了すると、プロジェクトディレクトリに build/index.js ファイルが生成されます。

サーバーのインストールと設定

Cherry StudioでMCPサーバーを追加するには：

1. 設定 > MCPサーバーを開きます。
2. 新しいサーバーを追加します：
   • 名前：任意の名前を設定します。
   • タイプ：STDIOを選択します。
   • コマンド：Node.jsの実行パスを指定します。
   • パラメータ：構築で生成された build/index.js ファイルのパスを入力します。
3. 環境変数を設定します：
   • GAODE_API_KEY：高德開放プラットフォームで申請したAPIキー。
   • DINGDING_ACCESS_TOKEN：钉钉ロボットから取得したアクセストークン。

💻 使用例

基本的な使用法

1. Cherry StudioでFunction Callをサポートする大規模言語モデル（例：硅基流动のQwen2.5 - 7B - Instruct）を選択し、必要な設定を行います。
2. AIが天気に関する質問を受け取ると、自動的にMCPサーバーを呼び出して天気情報を取得します。
3. MCPサーバーは高德APIを通じてデータを取得し、その結果をAIに返します。AIは情報を整理してユーザーに返信します。

⚠️ 重要な注意事項

• すべての環境変数が正しく設定され、サードパーティのAPIキーが有効であることを確認してください。
• 钉钉ロボットのカスタムキーワードを「天気」に設定して、メッセージ送信機能が正常に動作するようにしてください。
• 問題が発生した場合は、ネットワーク接続とAPI呼び出しの権限を確認してください。