Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client