A
securityF
licenseA
qualityA Model Context Protocol server that provides AI agents with tools to retrieve weather alerts and detailed forecasts for US locations using the National Weather Service API.
Last updated -
2
80
TypeScript
The Weather MCP Server provides an interface for accessing weather data and Feishu (Lark) document content.
- Weather Alerts: Retrieve weather alerts for any US state using the
get-alertstool with a two-letter state code. - Weather Forecast: Obtain weather forecasts for specific locations using the
get-forecasttool with latitude and longitude coordinates. - Feishu Document Access: Fetch content from various Feishu document types (documents, sheets, presentations, bitables, wikis, files, mindnotes) by providing their ID or URL through the
get-feishu-doctool.
Uses Express.js to provide HTTP/SSE transport capabilities for remote connections
Built with pure JavaScript ES Modules for direct execution without compilation steps
Requires Node.js 18.0.0+ to run the server and access the weather data APIs
Employs Zod for parameter validation in weather data requests
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。
飞书功能配置
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(基本信息)
- doc/docx: 文档 -
- 支持多种文档类型：
在Cursor中使用
- 配置MCP客户端 将此服务添加到你的MCP客户端配置中
- 使用天气功能
- 使用飞书文档功能
项目结构
故障排除
飞书功能不可用
- 检查是否设置了
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自动解析
- 优化配置管理系统
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A JavaScript ES Modules server that provides weather information including alerts and forecasts for US locations using the National Weather Service API.
Related Resources
Related MCP Servers
- -securityFlicense-qualityA lightweight microservice that fetches weather alerts and forecasts from the National Weather Service API, providing U.S. state-level alerts and location-based forecasts.Last updated -Python
- AsecurityFlicenseAqualityA Model Context Protocol server that provides tools to fetch weather alerts for US states and forecasts based on latitude/longitude coordinates using the US National Weather Service API.Last updated -280TypeScript
- -securityFlicense-qualityA standardized API server that enables AI agents and client applications to fetch current weather information for any location without directly interacting with external weather APIs.Last updated -Python