{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7hy2cv8rn98e","handle":"pangerl-mcp-server-weather","url":"https://wellknown.network/agents/pangerl-mcp-server-weather","links":{"self":"https://wellknown.network/agents/pangerl-mcp-server-weather/record.json","html":"https://wellknown.network/agents/pangerl-mcp-server-weather","markdown":"https://wellknown.network/agents/pangerl-mcp-server-weather/record.md","api":"https://wellknown.network/api/v1/agents/pangerl-mcp-server-weather","status":"https://wellknown.network/api/v1/agents/pangerl-mcp-server-weather/status","claim":"https://wellknown.network/agents/pangerl-mcp-server-weather/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/pangerl-mcp-server-weather/claim.json","badge":"https://wellknown.network/agents/pangerl-mcp-server-weather/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:pangerl-mcp-server-weather","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"pangerl-mcp-server-weather","summary":"天气查询MCP","description":"# mcp-server-weather\n\n基于 Model Context Protocol (MCP) 的天气查询服务，支持通过 MCP 工具获取指定城市的实时天气。适用于 AI 助手、自动化脚本等场景。\n\n---\n\n## 特性\n- 查询任意城市的实时天气\n- 支持 MCP 协议，易于集成\n\n---\n\n## 安装\n\n推荐使用 pip 安装：\n\n```bash\npip install .\n```\n\n或直接在本地开发环境运行：\n\n```bash\npython -m pangerl_mcp_server_weather.server\n```\n\n---\n\n## 获取和风天气 API Key\n\n本服务依赖和风天气（QWeather）的 API Key。请按照以下步骤获取：\n\n1. 访问和风天气开发者平台：[https://dev.qweather.com/docs/api/weather/weather-now](https://dev.qweather.com/docs/api/weather/weather-now)\n2. 注册并登录账号。\n3. 创建项目并获取你的 API Key。\n4. 在服务配置或环境变量中填写你的 API Key。\n\n详细开发配置和 API 使用说明请参考和风天气官方文档：[和风天气开发文档](https://dev.qweather.com/docs/)。\n\n---\n\n## MCP 配置\n\n在 Cursor、Claude Code 或其他支持 MCP 的客户端中，添加如下配置到 `.cursor/mcp.json` 或全局 MCP 配置文件：\n\n### uv 本地调试\n\n```json\n{\n  \"mcpServers\": {\n    \"weather\": {\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"type\": \"stdio\",\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/weather-python\",\n        \"run\",\n        \"main.py\"\n      ],\n      \"env\": {\n        \"QWEATHER_API_KEY\": \"xxx\",\n        \"QWEATHER_API_HOST\": \"https://xxx.re.qweatherapi.com\"\n      }\n    }\n  }\n}\n```\n\n### uvx\n\n```json\n{\n  \"mcpServers\": {\n    \"weather\": {\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\n        \"pangerl-mcp-server-weather\"\n      ],\n      \"env\": {\n        \"QWEATHER_API_KEY\": \"xxx\",\n        \"QWEATHER_API_HOST\": \"https://xxx.re.qweatherapi.com\"\n      }\n    }\n  }\n}\n```\n\n添加后，重启或刷新 MCP 设置即可。\n\n---\n\n## 工具参数说明\n\n- `get_current_weather`\n  - `city` (string, 必填): 城市名称。例如：\"beijing\"、\"上海\"。\n\n---\n\n## 开发与贡献\n\n欢迎提交 issue 和 PR 进行功能完善与 bug 修复。\n\n---\n\n## 参考资料\n- [和风天气开发文档](https://dev.qweather.com/docs/)\n- [README 编写指南](https://github.com/Tinymrsb/READMEhowto)\n- [GitHub 官方 README 说明](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)","publisher":null,"homepage":null,"repository":null,"version":"0.1.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:pangerl-mcp-server-weather","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.weather","name":"Weather","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.825,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"pangerl-mcp-server-weather","registry":"pypi","observedAt":"2026-09-10T09:26:50.370Z","publishedAt":"2025-07-23T03:36:40.113928Z","latestVersion":"0.1.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"pangerl-mcp-server-weather","url":"https://pypi.org/project/pangerl-mcp-server-weather/","firstSeenAt":"2026-09-10T09:25:25.997Z","fetchedAt":"2026-09-10T09:25:25.997Z","normalizedAt":"2026-09-10T09:25:25.997Z"}]},"firstSeenAt":"2026-09-10T09:25:25.997Z","updatedAt":"2026-09-10T09:26:50.370Z"}