🚀 简单 MCP 服务器
本项目是一个示例项目，以极简方式展示了如何构建一个 MCP 服务器。它能借助高德开放平台的 API 实现天气查询功能，还可通过钉钉群机器人将信息发送至指定钉钉群，为用户提供便捷的天气信息服务。
✨ 主要特性
- 天气查询：借助高德开放平台提供的天气查询 API，MCP 服务器可支持获取实时天气和未来天气预报。
- 钉钉群消息：能够通过钉钉群机器人，将信息发送到指定的钉钉群中。
💻 使用示例
基础用法
当用户询问“西安今天要穿棉袄吗”时，整个交互流程如下：
- AI 会自动判断是否需要调用 MCP 服务器。
- AI 根据 MCP 服务器的要求，提供西安的经纬度信息。
- MCP 服务器内部使用高德天气查询 API 获取天气数据，并将结果返回给 AI。
- AI 整理天气信息后，将其发送给用户。
同时，AI 还可以将天气信息通过钉钉群机器人发送到钉钉群中，效果如下：
📦 安装指南
环境配置
MCP 服务器构建与运行
- Node.js 22+：需确保安装了最新版本的 Node.js。
- Pnpm：使用 Pnpm 进行依赖管理。
MCP 客户端及大模型
推荐使用支持 MCP 协议的 AI 对话客户端，例如 Cherry Studio。本文示例中使用硅基流动提供的Qwen2.5 - 7B - Instruct模型，需先在硅基流动注册并获取 API 密钥，并在 Cherry Studio 中进行配置。
⚠️ 重要提示
选择具有 Function Call 功能的大模型，这些模型通常标记为（例如：🔧）。
构建步骤
- 克隆项目代码到本地路径，如
/Users/yourname/simple - mcp - server/。 - 打开终端并切换到该目录。
- 安装依赖：运行命令
pnpm i。 - 构建服务器：运行命令
pnpm build。
构建完成后，将在项目目录下生成build/index.js文件。
服务器安装与配置
在 Cherry Studio 中添加 MCP 服务器：
- 打开设置 > MCP 服务器。
- 添加新服务器：
- 名称：自定义名字。
- 类型：选择 STDIO。
- 命令：指定 Node.js 执行路径。
- 参数：输入构建生成的
build/index.js文件路径。
- 配置环境变量：
GAODE_API_KEY：高德开放平台申请的 API 密钥。DINGDING_ACCESS_TOKEN：钉钉机器人获取的访问令牌。
📚 详细文档
使用说明
- 在 Cherry Studio 中选择支持 Function Call 的大模型，如硅基流动的 Qwen2.5 - 7B - Instruct，并完成相应配置。
- 当 AI 接收到与天气相关的问题时，它将自动调用 MCP 服务器查询天气信息。
- MCP 服务器通过高德 API 获取数据后返回给 AI，AI 整理后回复用户。
⚠️ 重要提示
- 确保所有环境变量正确无误，并且第三方 API 密钥有效。
- 钉钉机器人的自定义关键字需设置为“天气”，以便正常触发消息推送功能。
- 如遇到问题，请检查网络连接和 API 调用权限。