项目简介

该项目是一个基于Model Context Protocol (MCP) 的服务器，名为“NewsFetcher”。它专注于提供股票市场分析所需的最新新闻资讯。通过与兼容MCP的AI助手或应用程序集成，可以为股票分析提供实时的背景信息。

主要功能点

• 股票新闻抓取: 能够根据股票代码（ticker）从Google News抓取最新的新闻文章。
• 结构化输出: 返回的文章数据包含标题、发布日期、描述和链接等详细信息。
• 灵活配置: 服务器内部可配置新闻的语言、地区和时间范围（默认为过去7天）。
• MCP协议集成: 无缝集成MCP协议，便于AI应用通过标准接口调用其功能。

安装步骤

1. 克隆仓库：

   git clone https://github.com/vashishtavarma/mcp-stocks-analyzer.git
   cd mcp-stocks-analyzer
   

2. 创建并激活Python虚拟环境（推荐）：

   python -m venv venv
   source venv/bin/activate  # Windows 用户请使用: venv\Scripts\activate
   

3. 安装所有依赖：

   pip install -r requirements.txt
   

服务器配置

MCP客户端通常需要一些配置信息才能与本服务器建立连接并使用其功能。以下是您在配置MCP客户端时可能需要提供的信息：

• 服务器名称: 'NewsFetcher' (这是此MCP服务器的唯一标识符)。
• 启动此服务器的命令: 'python' (指定Python解释器)。
• 启动命令的参数: 'main.py' (这是运行服务器的主要脚本)。
• 可用工具:
  • 工具名称: 'get_news_from_google'
  • 功能描述: 该工具用于从Google News抓取与特定股票代码相关的最新新闻文章。
  • 调用参数:
    • 'ticker' (类型: 字符串): 您需要提供一个股票代码作为参数，例如 "AAPL" 或 "TSLA"，服务器将根据此代码获取新闻。

基本使用方法

1. 启动MCP服务器： 在项目根目录下运行 'python main.py'。服务器启动后，将等待MCP客户端的连接。
2. 通过MCP客户端调用工具： 一旦服务器运行并与MCP客户端连接，AI助手就可以调用 'get_news_from_google' 工具，并提供股票代码作为参数，例如，如果客户端的调用接口是基于类似函数调用的形式，可能是 'get_news_from_google(ticker="GOOGL")'。
3. 获取结果： 工具将返回一个包含多篇文章的列表，每篇文章是一个字典，包含标题、日期、描述和链接等详细信息。