🌤️ Weather Microservice with MCP + UV

🌤️ 使用 MCP + UV 的天气微服务

一个轻量级、由 MCP 驱动的天气 API 服务，使用 uv 管理 Python 依赖，并通过 Docker 进行容器化部署。专为流畅的本地开发、Claude Desktop 集成和可扩展部署而打造。

---

🚀 功能

• 🧪 使用 uv 和 mcp 实现快速本地开发和实时重载
• 🐳 Docker 化，适用于生产或预发布环境
• 🧠 可与 Claude Desktop 集成
• 🔐 从 .env 或环境变量中安全加载密钥

---

⚙️ 运行服务

🧪 开发模式（使用 MCP Inspector）

以开发模式启动服务并启用热重载：

uv run mcp dev server.py

即时添加依赖：

uv run mcp dev server.py --with pandas --with numpy

将本地代码挂载为可编辑状态：

uv run mcp dev server.py --with-editable .

---

🧠 Claude Desktop 集成

将服务安装到 Claude Desktop：

uv run mcp install server.py

自定义名称：

uv run mcp install server.py --name "My Analytics Server"

注入环境变量：

uv run mcp install server.py -v API_KEY=abc123 -v DB_URL=postgres://...
uv run mcp install server.py -f .env

---

🔧 直接执行

如需更多控制或进行高级部署：

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("My App")

if __name__ == "__main__":
    mcp.run()

手动运行：

uv run python server.py
# or
uv run mcp run server.py

---

🐳 Docker 支持

🔨 构建镜像

docker build -t weather-service .

▶️ 运行容器

docker run --env-file .env -p 6274:6274 weather-service

---

📁 项目结构

.
├── server.py
├── .env
├── pyproject.toml
├── uv.lock
├── Dockerfile
└── README.md

---

🔒 环境变量

创建 .env 文件：

API_KEY=your_api_key_here
DB_URL=your_database_url_here

---

📦 依赖管理

使用 uv 管理并同步依赖：

uv pip install mcp
uv pip install pandas numpy
uv sync  # sync dependencies based on uv.lock

---

📃 许可证

MIT 许可证 – 可自由使用，请负责任地修改。