fogcast MCP

MCP地图位置

提供方 Local-AI-Workflows

地图位置 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个基于Python的MCP服务器,用于访问德国康斯坦茨的天气数据,提供实时天气和天气预报功能。

一句话选型结论

按资料字段整理

fogcast MCP 属于地图位置类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类地图位置 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

地图位置
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

天气数据Python本地部署MCP协议Python服务器天气预报数据集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
地址与路线

查地址、算路线、找附近地点。

位置检索

按区域筛门店、站点与设施。

地理数据

拉取经纬度、行政区等地理信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在地图位置场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
fogcast MCP当前 7 stdio · 本地进程 本地部署 有 2026-05-17
MCP Server C2f246e3 20 stdio · 本地进程 本地部署 有 2026-05-17
OpenStreetMap MCP Server 12 stdio · 本地进程 本地部署 有 2026-05-18
Baidu Maps 10 stdio · 本地进程 本地部署 有 2026-05-17
Google Maps (google-maps-aa2563d3) 7 未标注 未标注 无 2026-05-17
generative-ai 未标注 stdio · 本地进程 本地部署 有 2026-04-17

服务器档案

地图位置
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Local-AI-Workflows上游标注的维护方 Local-AI-Workflows
分类地图位置本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.2 KB
来自项目仓库与上游目录的原文,未做删改

Fogcast MCP服务器

用于访问德国康斯坦茨天气数据的Python MCP(模型上下文协议)服务器。该服务器提供使用官方MCP协议从Fogcast数据接口检索当前天气状况和天气预报的工具。

特性

  • 当前天气数据:访问DWD、OpenMeteo和当地气象站的实时天气测量数据
  • 天气预报:从多个天气模型中检索预报
  • 模型比较:比较不同天气模型的预报
  • MCP协议:使用官方MCP库实现完整的MCP服务器
  • 异步支持:异步操作可提高性能

项目结构```

fogcast_mcp/
├── main.py # Main entry point
├── requirements.txt # Python dependencies
├── README.md # This file
├── env.example # Environment configuration template
├── tests/ # Test suite
│ ├── init.py
│ └── test_app.py
└── src/ # Source code package
└── fogcast_mcp/ # Main package
├── init.py
├── app.py # MCP server application
├── config.py # Configuration management
├── models/ # Data models and DTOs
│ ├── init.py
│ ├── weather_data.py
│ └── api_response.py
├── integration/ # External API integration
│ ├── init.py
│ ├── http_client.py
│ └── fogcast_client.py
└── tools/ # MCP tool implementations
├── init.py
├── weather_tools.py
└── forecast_tools.py


## 安装

1. **克隆存储库**:```bash
git clone
cd fogcast_mcp
  1. 创建虚拟环境:```bash
    python -m venv venv
    source venv/bin/activate # On Windows: venv\Scripts\activate

1. **安装依赖项**:```bash
pip install -r requirements.txt

配置

服务器使用环境变量进行配置。创建一个 .env 文件或设置以下环境变量:

所需配置

  • FOGCAST_BASE_URL:Fogcast API服务器的基本URL(默认值: https://fogcast.in.htwg-konstanz.de/api)

可选配置

  • FOGCAST_TIMEOUT:请求超时(秒)(默认值: 30)
  • MCP_SERVER_NAME:MCP服务器名称(默认值: fogcast-weather)
  • MCP_SERVER_VERSION:MCP服务器版本(默认值: 1.0.0)
  • LOG_LEVEL:日志记录级别(默认值: INFO)

示例.env文件```env

FOGCAST_BASE_URL=https://fogcast.in.htwg-konstanz.de/api
LOG_LEVEL=DEBUG


**注:** 这 `.env` 应用程序启动时,文件会自动加载。如果没有安装python dotenv,可以手动设置环境变量。

## 用法

### 启动服务器```bash
python main.py

服务器将以MCP stdio模式启动,并通过stdin/stdout进行通信。

可用工具

MCP服务器提供以下工具:

1.获取当前天气

  • 工具: get_current_weather
  • 描述:获取康斯坦茨的当前天气数据
  • 参数:无

2.获取天气摘要

  • 工具: get_weather_summary
  • 描述:获取当前天气状况的摘要
  • 参数:无

3.获取可用型号

  • 工具: get_available_models
  • 描述:获取可用预测模型列表
  • 参数:无

4.获取预测

  • 工具: get_forecast
  • 描述:获取特定模型和日期时间的天气预报
  • 参数:
  • model_id (必填):预测模型的ID
  • datetime (可选):以YYYY-MM-DDTHH:MM:SSZ格式预测日期时间

5.获取当前预测

  • 工具: get_current_forecast
  • 描述:获取特定模型的当前预测
  • 参数:
  • model_id (必填):预测模型的ID

6.获取预测摘要

  • 工具: get_future_weather_forecast
  • 描述:获取预测条件摘要
  • 参数:
  • model_id (必填):预测模型的ID
  • datetime (可选):以YYYY-MM-DDTHH:MM:SSZ格式预测日期时间

7.比较模型

  • 工具: compare_models
  • 描述:比较多个模型的预测
  • 参数:
  • model_ids (必填):要比较的型号ID列表
  • datetime (可选):以YYYY-MM-DDTHH:MM:SSZ格式预测日期时间

可用资源

MCP服务器还提供以下资源:

  • fogcast://models -可用预测模型列表
  • fogcast://current-weather -康斯坦茨的当前天气数据
  • fogcast://weather-summary -当前天气状况概述

MCP协议

此服务器实现模型上下文协议(MCP),并通过stdin/stdout进行通信。它提供:

  • 工具:天气数据访问的可执行功能
  • 资源:天气信息的可读数据源
  • 异步操作:所有操作都是异步的,以获得更好的性能

数据模型

天气数据

  • timestamp:ISO格式日期时间
  • temperature:温度(摄氏度)
  • humidity:湿度百分比
  • pressure:大气压力(hPa)
  • wind_speed:风速(m/s)
  • wind_direction:风向(度)
  • visibility:能见度(单位:米)
  • precipitation:降水量(mm)
  • fog_probability:雾概率(0-1)

API响应

所有API响应都遵循以下结构:```json
{
"success": true,
"data": { ... },
"message": "Operation successful",
"error": null
}


## 发展

### 运行测试```bash
pytest

代码格式化```bash

black .


### 代码检查```bash
flake8 .

类型检查```bash

mypy .


## 生产部署

### 使用Docker编写开放式WebUI

这是推荐的部署方法。设置包括:```bash
# Start all services
docker compose up -d --build

# View logs
docker logs fogcast-mcp -f
docker logs openwebui -f

# Stop services
docker compose down

这将开始:

  • 打开WebUI 在http://localhost:8080
  • Fogcast MCP服务器 (stdio模式,通过docker exec访问)

Dockerfile基于Python 3.11-slim,包含所有必要的依赖项。

配置

MCP服务器需要在Open WebUI中配置:

通过打开WebUI管理UI**(推荐)

  1. 打开http://localhost:8080
  2. 转到管理面板→ 设置→ 外部工具
  3. 选择类型“OpenAPI”
  4. 作为基本URL使用“http://localhost:8000"
  5. 对于OpenAPI规范url,请使用“http://localhost:8000/openapi.json"

故障排除

400预测请求错误

如果您在调用预测工具时收到400 Bad Request错误,则此问题已在最新版本中得到修复。问题是Fogcast API要求将日期时间值四舍五入到最接近的小时。

解决方案: 更新到最新代码。日期时间值现在自动四舍五入到最接近的小时。

例子:

  • 输入: 2025-10-27T14:30:45Z
  • 自动四舍五入为: 2025-10-27T14:00:00Z

看 SOLUTION_SUMMARY.md 有关此修复程序的详细信息。

连接错误

如果您遇到连接错误:

  1. 检查一下 FOGCAST_BASE_URL 在您的 .env 文件
  2. 验证API是否可访问: curl https://fogcast.in.htwg-konstanz.de/api/models
  3. 检查您的网络连接和防火墙设置

环境变量未加载

如果未从加载环境变量 .env:

  1. 确保已安装python dotenv: pip install python-dotenv
  2. 验证 .env 文件存在于项目根目录中
  3. 检查文件权限: ls -la .env

测试

运行附带的测试脚本以验证一切正常:```bash

Test datetime rounding fix

python3 test_fix.py

Test full OpenWebUI request flow

python3 test_openwebui_request.py

Run full test suite

pytest
```

许可证

该项目根据MIT许可证获得许可。

支持

有关问题和疑问,请在存储库中创建问题或联系开发团队。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
fogcast MCP 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

fogcast MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

fogcast MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

fogcast MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

fogcast MCP 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 位置天气、数据集成、Python、天气预报、Python服务器。具体工具清单以官方文档为准。

fogcast MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

fogcast MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。