Weather MCP Server

Weather and Feishu MCP Server

A comprehensive Model Context Protocol (MCP) server that provides both weather data and Feishu document access to AI agents like Claude and cursor.

Features

Weather Tools

• get-alerts: Get weather alerts for a US state
• get-forecast: Get weather forecast for specific coordinates

Feishu (Lark) Tools

• get-feishu-doc: 获取飞书文档内容（纯文本格式）

Installation

Configuration

Weather功能

Weather功能无需配置，直接使用美国国家气象局(NWS)的公开API。

飞书功能配置

1. 创建飞书自建应用
   • 访问 飞书开放平台
   • 创建自建应用并获取App ID和App Secret
   • 详细文档
2. 应用权限配置
   • 为应用添加文档读取权限
   • 权限配置文档
3. 环境变量设置
   # 复制环境变量模板 cp .env.example .env # 编辑.env文件，填入你的飞书应用信息 FEISHU_APP_ID=your_feishu_app_id_here FEISHU_APP_SECRET=your_feishu_app_secret_here

Usage

作为MCP服务运行 (推荐)

Stdio 模式 (用于Claude Desktop等)

HTTP/SSE 模式 (用于网页应用)

工具使用示例

天气功能

• get-alerts - 参数: state (两字母州代码，如 "CA", "NY")
• get-forecast - 参数: latitude, longitude (纬度经度)

飞书文档功能

• get-feishu-doc - 参数: docId (文档ID或完整URL)
  • 支持多种文档类型：
    • doc/docx: 文档 - https://feishu.cn/docx/xxxxx
    • sheet/sheets: 表格 - https://feishu.cn/sheets/xxxxx
    • slides: 演示文稿 - https://feishu.cn/slides/xxxxx
    • bitable: 多维表格 - https://feishu.cn/bitable/xxxxx
    • wiki: 知识库 - https://feishu.cn/wiki/xxxxx
    • file: 云文档文件 - https://feishu.cn/file/xxxxx
    • mindnote: 思维笔记 - https://feishu.cn/mindnote/xxxxx (基本信息)

在Cursor中使用

1. 配置MCP客户端 将此服务添加到你的MCP客户端配置中
2. 使用天气功能
   请帮我查询加州的天气预警 请获取纬度37.7749，经度-122.4194的天气预报
3. 使用飞书文档功能
   请帮我读取这个飞书文档：https://feishu.cn/docx/doccnxxx... 请帮我读取这个飞书表格：https://feishu.cn/sheets/shtcnxxx... 请分析这个演示文稿：https://feishu.cn/slides/phtcnxxx... 请查看这个多维表格：https://feishu.cn/bitable/bblcnxxx...

项目结构

故障排除

飞书功能不可用

• 检查是否设置了 FEISHU_APP_ID 和 FEISHU_APP_SECRET 环境变量
• 确认飞书应用具有对应文档类型的读取权限：
  • 文档权限：读取与编辑文档
  • 表格权限：读取与编辑电子表格
  • 演示文稿权限：读取与编辑演示文稿
  • 多维表格权限：读取与编辑多维表格
  • 云文档权限：读取与编辑云空间文件
• 检查文档ID或URL格式是否正确，支持的格式：
  • https://feishu.cn/{type}/{id} (type: doc, docx, sheet, sheets, slides, bitable, wiki, file, mindnote)
  • 直接提供文档ID

天气功能限制

• 仅支持美国地区的天气数据（NWS API限制）
• 坐标必须在美国境内

技术特性

• 双协议支持: Stdio和HTTP/SSE传输模式
• 错误处理: 完善的错误提示和降级处理
• 环境适配: 开发和生产环境配置分离
• 类型安全: 使用Zod进行参数验证

License

ISC License

更新日志

• v1.0.0: 集成飞书文档读取功能，保持原有天气功能
  • 新增飞书文档内容获取
  • 支持文档URL自动解析
  • 优化配置管理系统