简易 MCP 服务器

这是一个示例项目，用极简方式演示如何构建 MCP 服务器。

• 天气查询：使用高德开放平台提供的天气查询 API实现 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

Cherry Studio 是一个 AI 对话客户端，其支持很多个大模型提供商，如：硅基流动、阿里云百炼、OpenAI 等几十个国内外提供商，各提供商分别提供很多大模型服务，各个大模型的能力也有差异，有免费和收费的，也有不同作用和能力的。 当然，Cherry Studio 也支持本地运行的大模型，如：Ollama、LLM Studio 等。

本文使用硅基流动提供的 Qwen2.5-7B-Instruct 模型，请先注册硅基流动账户，申请 API 密钥，并在 Cherry Studio 中配置 API 密钥。

注意：请选择带有 Function Call 功能的大模型 (Cherry Studio 中带 🔧 符号的大模型)，如：Qwen2.5-7B-Instruct。

高德开放平台 API 密钥

从高德开放平台申请 Web API 密钥 (key)。

构建

构建和运行

服务器使用 STDIO 传输模式，通常由客户端自动启动。要构建服务器 jar：

./mvnw clean install -DskipTests

构建完成后，在项目路径下会产生 target/mcp-weather-stdio-server-0.0.1-SNAPSHOT.jar 文件。

安装使用

在 Cherry Studio 中打开设置/MCP服务器，添加 MCP 服务器，如下图：

• 名称: 随意写
• 类型：STDIO
• 命令：node
• 参数：刚才构建的执行文件路径，即 /Users/yourname/simple-mcp-server/build/index.js
• 环境变量:
  • GAODE_API_KEY :高德开放平台申请的 Web API 32 位密钥 GAODE_API_KEY=your_api_key
  • DINGTALK_ACCESS_TOKEN: 创建钉钉群机器人的 Webhook 地址后面的64 位密钥 DINGTALK_ACCESS_TOKEN=your_access_token

使用

在 Cherry Studio 中新建对话，对话框下方开启 MCP 服务器和刚才安装的 MCP Server。

注意：当选择了带有 Function Call 功能的大模型时，下方才有 MCP 相关选项。