返回 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. 答案已经展示给你了!
即贴即用配置

MCP 客户端配置生成器

选择客户端,补齐所需环境变量,再复制根据当前 MCP 公开配置生成的完整文件

terminal
data_object

当前条目没有标准 command 或远程 URL,暂时无法安全生成客户端配置

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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