🚀 简单的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的大模型。
• 要确保所有依赖项和配置正确无误。
• 完成构建后再运行服务器。