Simple MCP Server C51

🚀 簡單 MCP 服務器

本項目是一個示例項目，以極簡方式展示瞭如何構建一個 MCP 服務器。它能借助高德開放平臺的 API 實現天氣查詢功能，還可通過釘釘群機器人將信息發送至指定釘釘群，為用戶提供便捷的天氣信息服務。

✨ 主要特性

• 天氣查詢：藉助高德開放平臺提供的天氣查詢 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 調用權限。