返回 MCP 目录
public公开dns本地运行

mcp-server-vsf

天气MCP服务器项目,通过Claude桌面客户端调用MCP协议实现天气查询服务

article

README

🚀 天气 MCP 服务器

本项目是一个天气 MCP 服务器,为用户提供与天气相关的服务,可结合 Claude for Desktop 客户端进行测试使用。

🚀 快速开始

服务运行测试

可使用以下命令运行服务:

uv run weather.py 

使用 Claude for Desktop 作为客户端测试

配置

打开并编辑文件:~/Library/Application\ Support/Claude/claude_desktop_config.json,内容如下:

{
    "mcpServers": {
        "weather": {
            "command": "/ABSOLUTE/PATH/TO/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/mcp-weather-server",
                "run",
                "weather.py"
            ]
        }
    }
}

重启 Claude for Desktop

重启不报错,且有锤子图标显示两个 Available MCP Tools,即为成功;否则,查看日志排查。

📚 详细文档

文档链接:https://modelcontextprotocol.io/quickstart/server

📚 Claude for Desktop 日志

  • 日志文件夹:~/Library/Logs/Claude
  • 来自具体 MCP Server 的日志:mcp-server-weather.log
  • MCP 连接通用日志:mcp.log

🔧 技术细节

工作原理

  1. 客户将您的问题发送给 Claude。
  2. Claude 分析可用的工具并决定使用哪一个。
  3. 客户端通过 MCP 服务器执行所选工具。
  4. 结果被发回给 Claude。
  5. Claude 制定了自然语言响应。
  6. 答案已经展示给你了!
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端