气象数据服务器

开放式Meteo MCP服务器（Java）

一台统一服务器 提供天气、雪况和空气质量数据 通过 三个API接口 （REST、MCP、聊天）-所有这些都由同一台设备提供支持 核心业务逻辑-通过 开放气象API.

概述

统一架构： 具有共享业务逻辑的单服务器应用程序 公开三个不同的API接口：

共享能力：

• 11 MCP工具 -天气、雪、空气质量、位置、警报、天文学、， 海洋的
• 4 MCP资源 -天气代码、参数、空气质量指数参考、瑞士 位置
• 3个MCP提示 -滑雪旅行、户外活动、旅行计划

快速开始

# Clone and build
git clone https://github.com/schlpbch/open-meteo-mcp-java.git
cd open-meteo-mcp-java
mvn clean install

# Run
mvn spring-boot:run

# Or with Docker
docker compose up --build

终点：

• 健康：http://localhost:8888/actuator/health
• 休息：http://localhost:8888/api/weather（及其他 /api/* 端点）
• MCP：http://localhost:8888/sse
• 聊天：http://localhost:8888/api/chat

架构： 所有三个API共享相同的天气服务、业务 逻辑和数据模型。选择最适合您用例的界面- REST用于直接集成，MCP用于AI助手，或Chat用于对话 互动。

MCP工具

核心工具

高级工具

Claude桌面集成

添加到您的Claude Desktop配置中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "open-meteo": {
      "command": "java",
      "args": ["-jar", "/path/to/open-meteo-mcp-2.0.2.jar"]
    }
  }
}

或者使用中的安装脚本 claude-desktop/.

配置

# Environment variables
AZURE_OPENAI_KEY=your_key
OPENAI_API_KEY=your_key
ANTHROPIC_API_KEY=your_key
REDIS_URL=redis://localhost:6379

# application.yml
openmeteo:
  chat:
    enabled: true
    memory:
      type: redis # or inmemory

测试

mvn test                    # Run all tests
mvn test jacoco:report      # With coverage report

当前： 577项测试通过，81%的指令覆盖率（超过80%的目标）

文档

• 建筑.md -系统设计
• docs/MCP_DOCUMENTATION.md -MCP协议 参考
• docs/openapi-open-meeo.yaml -REST API规范
• docs/openapi-chat.yaml -聊天API规范
• CLAUDE.md -AI开发指南

技术栈

• Java 25 使用虚拟线程
• 弹簧靴4.1.0-M4 / 春季AI 2.0.0-M4 / 春季安全7.1.0-M3
• 码头工人 （日蚀特穆林）/ Redis 8
• JUnit5 +Mockito+AssertJ+反应堆测试
• JJWT 0.12.7 （JWT身份验证）/ 杰克逊3 （JSON序列化）

许可证

Apache 2.0-请参阅 许可证

信用：

• 天气数据： 开放天气
• 协议： 模型上下文协议

v2.1.2 -企业就绪