天气股票信息服务

MCP服务器通过API集成提供实时天气警报、天气预报、股票市场数据和新闻信息。

  • by suraj2906
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 suraj2906/mcpserver

使用说明

MCP服务器-天气和股票信息服务

此MCP(模型控制协议)服务器通过各种API集成提供实时天气警报、预报、股市数据和新闻信息。

特性

  • 天气警报:获取美国各州的活跃天气警报
  • 天气预报:获取特定地点的详细天气预报
  • 股市数据:了解美国股市的最大赢家和输家
  • 股票新闻和情绪:获取特定股票的新闻和情绪分析
  • 一般新闻:按关键字和日期搜索新闻文章

先决条件

  • Python 3.x
  • uv 包管理器
  • API密钥用于:
    • Alpha Vantage(用于股票数据)
    • 新闻API(用于新闻数据)

设置

  1. 克隆存储库:
git clone https://github.com/suraj2906/mcpServer
cd mcpServer
  1. 创建虚拟环境并安装依赖项:
uv venv
uv pip install -r requirements.txt
  1. 创建一个 .env 使用API密钥在项目根目录中创建文件:
ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key
NEWS_API_KEY=your_news_api_key

配置

要将此MCP服务器与Claude一起使用,您需要将以下配置添加到Claude的配置文件中:

  1. 打开Claude的设置
  2. 转到“文件”>“设置”>“开发人员”>“编辑配置”
  3. 添加以下配置:
{
    "mcpServers": {
        "weatherAndStock": {
            "command": "uv",
            "args": [
                "--directory",
                "YOUR\\REPOSITORY\\PATH",
                "run",
                "mcp-server.py"
            ]
        }
    }
}

注意:确保调整路径(C:\\Users\\asus\\code\\mcpServer)以匹配您的实际项目位置。

可用工具

天气工具

  • get_weather_alerts(state):获取美国某个州的活跃天气警报
    • 例子: get_weather_alerts("CA")
  • get_forecast(latitude, longitude):获取某个地点的天气预报
    • 例子: get_forecast(37.7749, -122.4194)

股票市场工具

  • get_top_gainers_losers():了解美国股市的最大赢家和输家
  • get_news_and_sentiments(ticker):获取股票的新闻和情绪分析
    • 例子: get_news_and_sentiments("AAPL")

新闻工具

  • get_news_today(keyword, date):获取关键字和日期的新闻文章
    • 例子: get_news_today("technology", "2024-03-20")

错误处理

服务器为API请求提供了强大的错误处理功能,并将在以下情况下返回适当的错误消息:

  • 缺少API密钥
  • API请求失败
  • 提供的参数无效
  • 未找到符合给定标准的数据

贡献

请随时提交问题和增强请求!