MCP Server for Measure Space API Services

这是一个基于Model Context Protocol (MCP)的服务器，用于从measurespace.io获取天气、气候和空气质量预报以及地理编码服务。该服务器使用FastAPI和MCP框架构建，提供了各种与天气、气候、空气质量及地理编码相关的工具，这些工具可以被AI助手用来检索天气、气候和空气质量预报等信息。

功能

• 下5天每小时天气预报
• 下15天每日天气预报
• 下9个月每日气候预报
• 下4天每小时和每日空气质量预报
• 地理编码服务，用于根据城市名称查找经纬度
• 地理编码服务，用于根据经纬度查找最近的城市
• 时区信息
• 天文数据（日出、日落）

要求

• Python 3.12+
• uv 包管理器
• 来自measurespace.io的相关服务API密钥

安装

通过Smithery安装

要通过Smithery自动安装此服务器到Claude Desktop：

npx -y @smithery/cli install @MeasureSpace/measure-space-mcp-server --client claude

手动安装

1. 克隆此仓库：

   git clone git@github.com:MeasureSpace/measure-space-mcp-server.git
   cd measure-space-mcp-server
   

2. 使用uv安装依赖项：

   uv venv
   uv pip install -e .
   

3. 在项目根目录创建一个.env文件，并添加来自measurespace.io的相关API密钥：

   GEOCODING_API_KEY=<你的地理编码API密钥>
   HOURLY_WEATHER_API_KEY=<你的每小时天气API密钥>
   DAILY_WEATHER_API_KEY=<你的每日天气API密钥>
   DAILY_CLIMATE_API_KEY=<你的每日气候API密钥>
   AIR_QUALITY_API_KEY=<你的空气质量API密钥>
   

   注意：您只需提供所需服务的API密钥。

使用方法

使用Claude Desktop应用中的服务器

打开cladue_desktop_config.json文件并添加以下设置。重启Claude Desktop应用。如果您不知道在哪里找到cladue_desktop_config.json文件，请参阅此教程。

{
  "mcpServers": {
    "MeasureSpace": {
      "command": "/<您的uv路径>/uv",
      "args": [
        "--directory",
        "/<您的measure-space-mcp-server文件夹路径>/measure-space-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

运行服务器

# 进入您的uv构建环境
python main.py

默认情况下，服务器将在http://localhost:8000启动。