使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的天气服务器,旨在演示 MCP 服务器的核心概念和功能。它通过资源和工具的形式,向 LLM 客户端提供实时的天气数据和天气预报服务。

主要功能点

  • 资源 (Resources)
    • 提供当前天气信息资源,URI 为 'weather://旧金山/current' (默认城市为旧金山)。
    • 资源以 JSON 格式返回,包含温度、天气状况、湿度和风速等信息。
  • 工具 (Tools)
    • 提供 'get_forecast' 工具,用于获取指定城市的天气预报。
    • 工具接受城市名称和天数作为参数,返回未来几天的天气预报信息。

安装步骤

  1. 安装依赖: 在仓库根目录下,打开终端并运行以下命令安装项目依赖:
    npm install
  2. 构建服务器: 运行以下命令构建服务器代码:
    npm run build

服务器配置

要将此 MCP 服务器与 MCP 客户端(如 Claude Desktop)配合使用,您需要配置客户端以连接到此服务器。在客户端的配置文件(例如 'claude_desktop_config.json')中,添加以下服务器配置信息:

{
  "mcpServers": {
    "weather-server": {
      "command": "/path/to/mcp-init/build/index.js"
    }
  }
}
  • 'weather-server': 服务器名称,您可以自定义。
  • 'command': 重要:请将 '/path/to/mcp-init/build/index.js' 替换为您本地 'mcp-init' 仓库 'build/index.js' 文件的绝对路径

基本使用方法

  1. 启动服务器: 当 MCP 客户端启动时,它会根据配置文件中的 'command' 自动启动此 MCP 服务器。您无需手动运行 'index.js'。
  2. 客户端访问资源和工具: 配置完成后,您的 MCP 客户端即可与此天气服务器通信。客户端可以通过 MCP 协议请求访问 'weather://旧金山/current' 资源以获取当前天气,或调用 'get_forecast' 工具查询天气预报。具体如何操作资源和工具取决于您使用的 MCP 客户端的功能和界面。例如,在支持工具调用的 LLM 应用中,您可以指示 LLM 使用 'get_forecast' 工具来获取天气预报信息。

信息

分类

网页与API