关键词

天气信息实时天气天气预报高德APINode.js

使用说明

项目简介

本示例项目 'simple-mcp-server' 演示了如何构建一个基础的 MCP (Model Context Protocol) 服务器。它通过调用高德开放平台的天气查询 API，为支持 MCP 协议的 AI 客户端提供实况天气和未来天气预报查询功能。

主要功能点

  • 实时天气查询: 根据提供的经纬度，获取指定地点的当前天气状况，包括天气现象、温度、风向风力、湿度等信息。
  • 未来天气预报: 根据提供的经纬度，获取未来几天的天气预报，包括每天的天气、温度、风向风力等详细信息。
  • 标准 MCP 协议: 使用 '@modelcontextprotocol/sdk' 库构建，遵循 MCP 协议规范，易于与支持 MCP 协议的客户端集成。
  • 易于部署和使用: 采用 Node.js 开发，构建和运行过程简单，配置方便。

安装步骤

  1. 环境准备: 确保已安装 Node.js (22+ 版本) 和 pnpm。
  2. 下载代码: 将仓库代码克隆到本地。
  3. 安装依赖: 在项目根目录下打开命令行工具，运行 'pnpm install' 安装项目依赖。
  4. 构建项目: 运行 'pnpm build' 命令构建项目。构建成功后，会在项目根目录下生成 'build/index.js' 文件，此文件为服务器执行文件。
  5. 申请高德API密钥: 访问 高德开放平台 申请 Web API 服务密钥 (key)。

服务器配置

在 MCP 客户端（如 Cherry Studio）中添加 MCP 服务器时，需要配置以下信息：

  • 服务器名称: 可以自定义，例如 'Simple Weather Server'。

  • 类型 (Type): 选择 'STDIO' (标准输入输出)。

  • 命令 (Command): 填写 'node'，表示使用 Node.js 运行。

  • 参数 (Arguments): 填写服务器执行文件的路径，即 'build/index.js' （请根据实际项目路径填写）。

  • 环境变量 (Environment Variables): 添加高德API密钥，变量名为 'GAODE_API_KEY'，值为您在高德开放平台申请的 API 密钥。例如： 'GAODE_API_KEY=your_api_key'。

    MCP客户端配置示例 (JSON 格式，仅供参考，客户端配置界面通常为表单形式，无需填写JSON):

    {
  "serverName": "Simple Weather Server",
  "transport": "stdio",
  "command": "node",
  "args": ["build/index.js"],
  "env": {
    "GAODE_API_KEY": "your_api_key"
  }
}

基本使用方法

  1. 启动 MCP 服务器: 在 MCP 客户端中添加并启用配置好的 "Simple Weather Server"。
  2. 在对话中使用: 在支持 Function Call 功能的大模型对话中，当用户提出与天气相关的问题时，模型会自动判断是否需要调用 MCP 服务器。例如，询问 "北京今天天气怎么样" 或 "明天上海会下雨吗"。
  3. 模型调用工具: 如果模型判断需要查询天气，会根据用户提问提取地点信息，并调用 MCP 服务器提供的 "获取实时天气" 或 "获取未来天气" 工具，将地点经纬度作为参数传递给服务器。
  4. 服务器返回结果: MCP 服务器接收到请求后，会调用高德天气 API 获取天气数据，并将结果以文本形式返回给模型。
  5. 模型整合信息: 模型会将 MCP 服务器返回的天气信息整合到回复中，呈现给用户。

注意: 请确保您使用的大模型支持 Function Call 功能，并且在 MCP 客户端中正确配置了 MCP 服务器和 API 密钥。

信息

分类

网页与API

访问项目