AI导哈

天气与飞书文档服务

一个提供天气数据和飞书文档访问的模型上下文协议（MCP）服务器，适用于AI代理如Claude和Cursor。

  • by 630156145
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 630156145/weather-server-javascript

使用说明

天气与飞舒MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供对Claude和cursor等AI代理的天气数据和Feishu文档访问。

特性

天气工具

  • 获取警报：获取美国某州的天气警报
  • 获取预报：获取特定坐标的天气预报

飞树（云雀）工具

  • 获取飞舒医生: 获取飞书文档内容（纯文本格式）

安装

npm install

配置

Weather功能

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

飞书功能配置

  1. 创建飞书自建应用

  2. 应用权限配置

  3. 环境变量设置

    # 复制环境变量模板
cp .env.example .env

# 编辑.env文件，填入你的飞书应用信息
FEISHU_APP_ID=your_feishu_app_id_here
FEISHU_APP_SECRET=your_feishu_app_secret_here

用法

作为MCP服务运行 (推荐)

Stdio 模式 (用于Claude Desktop等)

npm start
# 或者
node index.mjs stdio

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

node index.mjs sse [port]
# 默认端口8080，或自定义端口
node index.mjs sse 3001

工具使用示例

天气功能

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

飞书文档功能

  • get-feishu-doc - 参数: docId (文档ID或完整URL)
    • 支持多种文档类型：
      • doc/docx: 文档 - https://feishu.cn/docx/xxxxx
      • 纸张: 表格 - https://feishu.cn/sheets/xxxxx
      • 幻灯片: 演示文稿 - https://feishu.cn/slides/xxxxx
      • 多维表格: 多维表格 - https://feishu.cn/bitable/xxxxx
      • 维基: 知识库 - https://feishu.cn/wiki/xxxxx
      • 文件: 云文档文件 - https://feishu.cn/file/xxxxx
      • 记忆: 思维笔记 - 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...

项目结构

weather-server-javascript/
├── index.mjs              # 主服务文件
├── services/
│   └── feishu.mjs        # 飞书服务模块
├── config/
│   └── index.mjs         # 配置管理
├── .env.example          # 环境变量模板
├── package.json          # 依赖管理
└── README.md             # 说明文档

故障排除

飞书功能不可用

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

天气功能限制

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

技术特性

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

许可证

ISC许可证

更新日志

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

相关 MCP