Weather

Fornece dados meteorológicos usando a API do Serviço Nacional de Meteorologia dos EUA (NWS). Construído com módulos ES JavaScript puro.

GitHubExperimente este MCPPatrocinado

Documentação

Weather and Feishu MCP Server

Um servidor abrangente do Model Context Protocol (MCP) que fornece tanto dados meteorológicos quanto acesso a documentos do Feishu para agentes de IA como Claude e cursor.

Recursos

Ferramentas de Clima

get-alerts: Obter alertas meteorológicos para um estado dos EUA
get-forecast: Obter previsão do tempo para coordenadas específicas

Ferramentas do Feishu (Lark)

get-feishu-doc: Obter conteúdo de documentos do Feishu (formato de texto puro)

Instalação

npm install

Configuração

Funcionalidade do Weather

A funcionalidade Weather não requer configuração, usando diretamente a API pública do Serviço Nacional de Meteorologia dos EUA (NWS).

Configuração da funcionalidade Feishu

Criar um aplicativo personalizado do Feishu
- Acesse a Plataforma Aberta do Feishu
- Crie um aplicativo personalizado e obtenha o App ID e o App Secret
- Documentação detalhada
Configuração de permissões do aplicativo
- Adicione permissão de leitura de documentos ao aplicativo
- Documentação de configuração de permissões

Configuração de variáveis de ambiente

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

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

Uso

Executar como serviço MCP (recomendado)

Modo Stdio (para Claude Desktop, etc.)

npm start
# 或者
node index.mjs stdio

Modo HTTP/SSE (para aplicativos web)

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

Exemplos de uso das ferramentas

Funcionalidade de clima

get-alerts - Parâmetros: state (código de estado de duas letras, como "CA", "NY")
get-forecast - Parâmetros: latitude, longitude (latitude e longitude)

Funcionalidade de documentos do Feishu

get-feishu-doc - Parâmetros: docId (ID do documento ou URL completo)
- Suporta vários tipos de documentos:
  - doc/docx: Documento - https://feishu.cn/docx/xxxxx
  - sheet/sheets: Planilha - https://feishu.cn/sheets/xxxxx
  - slides: Apresentação - https://feishu.cn/slides/xxxxx
  - bitable: Tabela multidimensional - https://feishu.cn/bitable/xxxxx
  - wiki: Base de conhecimento - https://feishu.cn/wiki/xxxxx
  - file: Arquivo de documento em nuvem - https://feishu.cn/file/xxxxx
  - mindnote: Notas mentais - https://feishu.cn/mindnote/xxxxx (informações básicas)

Uso no Cursor

Configurar o cliente MCP Adicione este serviço à configuração do seu cliente MCP

Usar a funcionalidade de clima

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

Usar a funcionalidade de documentos do Feishu

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

Estrutura do projeto

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

Solução de problemas

Funcionalidade do Feishu indisponível

Verifique se as variáveis de ambiente FEISHU_APP_ID e FEISHU_APP_SECRET estão definidas
Confirme se o aplicativo Feishu tem permissões de leitura para o tipo de documento correspondente:
- Permissão de documento: ler e editar documentos
- Permissão de planilha: ler e editar planilhas
- Permissão de apresentação: ler e editar apresentações
- Permissão de tabela multidimensional: ler e editar tabelas multidimensionais
- Permissão de documento em nuvem: ler e editar arquivos do espaço em nuvem
Verifique se o formato do ID do documento ou URL está correto. Formatos suportados:
- https://feishu.cn/{type}/{id} (type: doc, docx, sheet, sheets, slides, bitable, wiki, file, mindnote)
- Fornecer diretamente o ID do documento

Limitações da funcionalidade de clima

Suporta apenas dados meteorológicos dos EUA (limitação da API NWS)
As coordenadas devem estar dentro dos EUA

Características técnicas

Suporte a dois protocolos: modos de transmissão Stdio e HTTP/SSE
Tratamento de erros: mensagens de erro completas e tratamento de degradação
Adaptação de ambiente: configurações separadas para ambientes de desenvolvimento e produção
Segurança de tipos: validação de parâmetros usando Zod

Licença

ISC License

Registro de alterações

v1.0.0: Integração da funcionalidade de leitura de documentos do Feishu, mantendo a funcionalidade de clima existente
- Nova funcionalidade de obtenção de conteúdo de documentos do Feishu
- Suporte à análise automática de URLs de documentos
- Sistema de gerenciamento de configuração otimizado