项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器,专注于提供股票相关的实时新闻搜索功能。它利用 Tavily API 获取最新的股票新闻,并通过标准化的 MCP 接口将其提供给兼容的 LLM 客户端(如 Cline, Cursor, Claude Desktop等),使得AI能够获取和利用实时的金融信息。

主要功能点

  • 实时股票新闻搜索: 通过集成外部新闻源(Tavily API),提供针对特定股票的最新新闻。
  • 可定制的搜索: 支持配置搜索参数,如最大结果数、搜索深度、结果最低相关度评分等。
  • 域名过滤: 可以指定包含或排除特定域名的新闻来源。
  • 标准化接口: 作为 MCP 服务器,通过 JSON-RPC 协议与 LLM 客户端通信,以工具(Tool)的形式提供新闻搜索能力。

安装步骤

  1. 安装 Node.js: 确保你的系统安装了 Node.js (推荐 v16 或更高版本)。

  2. 获取 Tavily API Key: 你需要一个 Tavily API Key 才能使用新闻搜索功能。

  3. 运行服务器: 打开终端,执行以下命令:

    npx -y search-stock-news-mcp@latest

    或者通过 Smithery 为 Claude Desktop 安装:

    npx -y @smithery/cli install search-stock-news-mcp --client claude

服务器配置(供MCP客户端参考)

为了让你的 MCP 客户端连接并使用此服务器,通常需要在客户端的 MCP 设置中添加如下配置项。具体配置方式请参考你的 MCP 客户端文档,以下是配置中通常需要的关键信息:

  • 名称 (name): 'search-stock-news-mcp' (客户端用来识别服务器的唯一名称)
  • 命令 (command): 'npx' (启动服务器的程序)
  • 参数 (args): '-y', 'search-stock-news-mcp@latest' (传递给命令的参数,用于运行服务器)
  • 环境变量 (env): 用于设置 Tavily API Key。你需要添加一个名为 'TAVILY_API_KEY' 的环境变量,并将其值设为你的实际 API Key。例如:'{"TAVILY_API_KEY": "your-api-key-here"}'。

基本使用方法

成功安装和配置服务器后,你的 MCP 客户端(AI)将能够识别并调用名为 'search-stock-news' 的工具。AI 会根据用户指令或其自身需求,构造包含以下参数的请求来调用此工具:

  • 'symbol' (字符串): 需要搜索新闻的股票代码(例如:'AAPL')。
  • 'companyName' (字符串): 需要搜索新闻的公司全称(例如:'Apple Inc.')。
  • 'days' (数字): 搜索过去多少天内的新闻。
  • 'minScore' (数字): 结果的最低相关度评分(通常在0到1之间)。

AI 调用工具后,服务器将返回一个包含搜索结果的 JSON 字符串,AI 可以解析并利用这些信息来回答用户关于股票新闻的提问。

例如,AI 可能会构造一个调用:搜索过去7天内苹果公司(股票代码 AAPL)评分高于0.6的新闻。

信息

分类

网页与API