MCP Weather Stdio Server

🚀 簡單的MCP服務器

這是一個示例項目，以極簡方式演示如何構建一個MCP Server。藉助該項目，可使用高德開放平臺的天氣查詢API實現MCP Server，獲取即時和未來天氣信息。

🚀 快速開始

效果展示

如上圖所示，整個交互流程如下：

1. 用戶詢問："西安今天需要穿棉襖嗎？"
2. AI自動判斷是否需要調用天氣MCP Server。
3. AI根據MCP Server的要求，將西安的經緯度信息提供給MCP Server。
4. MCP Server內部調用了高德提供的天氣查詢API，並將結果返回給AI。
5. AI對天氣信息進行彙總整理後，輸出給用戶。

環境準備

MCP Server的構建與運行

• Java 17或更高版本。
• Maven 3.6或更高版本。
• 需理解Spring Boot和Spring AI概念。
• （可選）可使用Claude Desktop等AI助手工具。

MCP Client和大模型

支持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傳輸模式，通常由客戶端自動啟動。要構建server 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的大模型。
• 要確保所有依賴項和配置正確無誤。
• 完成構建後再運行服務器。