天气数据服务器

一个基于Node.js/TypeScript的服务器,通过模型上下文协议(MCP)提供天气数据、电子邮件集成和实用工具,适用于需要天气信息和邮件服务的开发场景。

  • by atta541
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 atta541/mcp-server

使用说明

气象MCP服务器 Node.js/TypeScript服务器,通过模型上下文协议(MCP)提供天气数据、电子邮件集成和实用工具。 它从美国国家气象局获取天气警报和预报,允许通过Gmail发送和接收电子邮件,并包括笑话和比特币价格等有趣的附加功能。 特性 天气警报:获取美国任何州的当前天气警报。 天气预报:获取美国任何地点(纬度/经度)的详细天气预报。 电子邮件集成:#天气MCP服务器

Node.js/TypeScript服务器,通过模型上下文协议(MCP)提供天气数据、电子邮件集成和实用工具。它从美国国家气象局获取天气警报和预报,允许通过Gmail发送和接收电子邮件,并包括笑话和比特币价格等有趣的附加功能。

特性

  • 天气警报:获取美国任何州的当前天气警报
  • 天气预报:获取美国任何地点的详细天气预报(纬度/经度)
  • 电子邮件集成:
    • 从Gmail获取您最近的电子邮件
    • 通过Gmail发送电子邮件
  • 公用事业:
    • 随机开个玩笑
    • 获取当前比特币价格 USD

需求

  • Node.js v16或更高版本
  • TypeScript

设置

  1. 克隆存储库:

    git clone <repository-url>
    cd weather-mcp-server
    
  2. 安装依赖项:

    npm install
    
  3. 配置环境变量:

    创建一个 .env 项目根目录中的文件,内容如下:

    EMAIL_USER=your-email@gmail.com
    EMAIL_PASSWORD=your-app-password
    

    备注:对于Gmail,如果启用了2FA,则必须使用应用程序密码。

  4. 构建项目:

    npm run build
    

用法

该服务器被设计为在stdio上作为MCP(模型上下文协议)服务器运行。您可以将其与MCP兼容的客户端或工具集成。

要启动服务器,请执行以下操作:

npm start

提供的MCP工具

工具 说明
get-alerts 获取美国某个州的天气警报
get-forecast 获取纬度/经度的天气预报
get-recent-emails 从Gmail获取您最近的电子邮件
send-email 通过Gmail发送电子邮件
get-random-joke 随机开个玩笑
get-bitcoin-price 以美元获取当前比特币价格

发展

  • 源代码在 src/ 目录
  • TypeScript配置在 tsconfig.json

可用脚本

npm run build    # Build the TypeScript project
npm start        # Start the MCP server
npm run dev      # Development mode (if configured)

环境变量

变量 描述
EMAIL_USER 您的Gmail地址
EMAIL_PASSWORD 您的Gmail应用密码

⚠️ 永远不要承诺你的 .env 文件或凭据到版本控制!

贡献

  1. 分叉存储库
  2. 创建要素分支: git checkout -b feature-name
  3. 进行更改并提交: git commit -m 'Add feature'
  4. 推到分支: git push origin feature-name
  5. 提交拉取请求

许可证

国际协调委员会 从Gmail获取您最近的电子邮件。 通过Gmail发送电子邮件。 公用设施: 随便开个玩笑。 以美元获取当前比特币价格。 需求 Node.js v16或更高版本 TypeScript 设置 克隆存储库: 应用 安装依赖项: 应用 配置环境变量: 在项目根目录中创建一个.env文件,内容如下: 应用

注意:对于Gmail,如果启用了2FA,则必须使用应用程序密码。 构建项目: 应用 用法 该服务器被设计为在stdio上作为MCP(模型上下文协议)服务器运行。 您可以将其与MCP兼容的客户端或工具集成。 要启动服务器,请执行以下操作: 应用 提供的MCP工具 获取警报:获取美国某个州的天气警报。 获取天气预报:获取纬度/经度的天气预报。 获取最近的电子邮件:从Gmail获取您最近的电子邮件。 发送电子邮件:通过Gmail发送电子邮件。 随机笑话:随机笑话。 get-bitcoin-price: 以美元获取当前比特币价格。 发展 源代码在src/目录中。 TypeScript配置在tsconfig.json中。 环境变量 变量描述 EMAIL_USER您的Gmail地址 EMAIL_PASSWORD您的Gmail应用密码 切勿将.env文件或凭据提交到版本控制! 许可证 国际协调委员会