Weather

Proporciona datos meteorológicos utilizando la API del Servicio Meteorológico Nacional de EE. UU. (NWS). Construido con módulos ES de JavaScript puro.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Weather y Feishu

Un servidor integral del Protocolo de Contexto de Modelos (MCP) que proporciona tanto datos meteorológicos como acceso a documentos de Feishu para agentes de IA como Claude y cursor.

Características

Herramientas meteorológicas

get-alerts: Obtener alertas meteorológicas para un estado de EE. UU.
get-forecast: Obtener pronóstico del tiempo para coordenadas específicas

Herramientas de Feishu (Lark)

get-feishu-doc: Obtener el contenido de documentos de Feishu (formato de texto plano)

Instalación

npm install

Configuración

Funcionalidad meteorológica

La funcionalidad meteorológica no requiere configuración; utiliza directamente la API pública del Servicio Meteorológico Nacional (NWS) de EE. UU.

Configuración de la funcionalidad de Feishu

Crear una aplicación autoconstruida de Feishu
- Visita Plataforma abierta de Feishu
- Crea una aplicación autoconstruida y obtén el ID de la aplicación y el Secreto de la aplicación
- Documentación detallada
Configuración de permisos de la aplicación
- Agrega permisos de lectura de documentos a la aplicación
- Documentación de configuración de permisos

Configuración de variables de entorno

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

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

Uso

Ejecutar como servicio MCP (recomendado)

Modo Stdio (para Claude Desktop, etc.)

npm start
# 或者
node index.mjs stdio

Modo HTTP/SSE (para aplicaciones web)

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

Ejemplos de uso de herramientas

Funcionalidad meteorológica

get-alerts - Parámetros: state (código de estado de dos letras, como "CA", "NY")
get-forecast - Parámetros: latitude, longitude (latitud y longitud)

Funcionalidad de documentos de Feishu

get-feishu-doc - Parámetros: docId (ID del documento o URL completa)
- Admite múltiples tipos de documentos:
  - doc/docx: Documentos - https://feishu.cn/docx/xxxxx
  - sheet/sheets: Hojas de cálculo - https://feishu.cn/sheets/xxxxx
  - slides: Presentaciones - https://feishu.cn/slides/xxxxx
  - bitable: Tablas multidimensionales - https://feishu.cn/bitable/xxxxx
  - wiki: Base de conocimiento - https://feishu.cn/wiki/xxxxx
  - file: Archivos de documentos en la nube - https://feishu.cn/file/xxxxx
  - mindnote: Notas de pensamiento - https://feishu.cn/mindnote/xxxxx (información básica)

Uso en Cursor

Configurar el cliente MCP Agrega este servicio a la configuración de tu cliente MCP

Usar la funcionalidad meteorológica

请帮我查询加州的天气预警
请获取纬度37.7749，经度-122.4194的天气预报

Usar la funcionalidad de documentos de Feishu

请帮我读取这个飞书文档：https://feishu.cn/docx/doccnxxx...
请帮我读取这个飞书表格：https://feishu.cn/sheets/shtcnxxx...
请分析这个演示文稿：https://feishu.cn/slides/phtcnxxx...
请查看这个多维表格：https://feishu.cn/bitable/bblcnxxx...

Estructura del proyecto

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

Solución de problemas

Funcionalidad de Feishu no disponible

Verifica si se han configurado las variables de entorno FEISHU_APP_ID y FEISHU_APP_SECRET
Confirma que la aplicación de Feishu tiene permisos de lectura para el tipo de documento correspondiente:
- Permisos de documentos: Leer y editar documentos
- Permisos de hojas de cálculo: Leer y editar hojas de cálculo
- Permisos de presentaciones: Leer y editar presentaciones
- Permisos de tablas multidimensionales: Leer y editar tablas multidimensionales
- Permisos de documentos en la nube: Leer y editar archivos del espacio en la nube
Verifica que el ID del documento o el formato de la URL sea correcto; formatos admitidos:
- https://feishu.cn/{type}/{id} (tipo: doc, docx, sheet, sheets, slides, bitable, wiki, file, mindnote)
- Proporcionar directamente el ID del documento

Limitaciones de la funcionalidad meteorológica

Solo admite datos meteorológicos de EE. UU. (limitación de la API de NWS)
Las coordenadas deben estar dentro de los Estados Unidos

Características técnicas

Soporte de doble protocolo: Modos de transmisión Stdio y HTTP/SSE
Manejo de errores: Mensajes de error completos y manejo de degradación
Adaptación del entorno: Configuración separada para entornos de desarrollo y producción
Seguridad de tipos: Validación de parámetros con Zod

Licencia

Licencia ISC

Registro de cambios

v1.0.0: Integración de la funcionalidad de lectura de documentos de Feishu, manteniendo la funcionalidad meteorológica original
- Nueva obtención de contenido de documentos de Feishu
- Soporte para análisis automático de URL de documentos
- Sistema de gestión de configuración optimizado