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-alerts
tool with a two-letter state code.Weather Forecast: Obtain weather forecasts for specific locations using the
get-forecast
tool 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-doc
tool.
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。
飞书功能配置
创建飞书自建应用
应用权限配置
为应用添加文档读取权限
环境变量设置
# 复制环境变量模板 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中使用
配置MCP客户端 将此服务添加到你的MCP客户端配置中
使用天气功能
请帮我查询加州的天气预警 请获取纬度37.7749,经度-122.4194的天气预报使用飞书文档功能
请帮我读取这个飞书文档: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自动解析
优化配置管理系统
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
- AsecurityFlicenseAqualityA 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 -288
- -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 -
- -securityFlicense-qualityProvides weather forecast and alert data for US locations through the National Weather Service API, enabling access to real-time weather alerts by state and detailed forecasts by coordinates.Last updated -
- AsecurityFlicenseAqualityEnables AI assistants to access real-time US weather forecasts and alerts through the National Weather Service API.Last updated -25