SuperAPI AI 工具集

YFinance-Trader-MCP-ClaudeDesktop

YFinance-Trader-MCP-ClaudeDesktop 是一个基于 MCP(模型上下文协议)的工具,利用 yfinance 库提供股票市场数据与交易能力,专为 Claude Desktop 适配。它支持实时股票报价、公司信息与财务指标、历史价格数据、股票代码搜索、分析师推荐以及内部交易跟踪等功能。用户可通过 Claude Desktop 直接查询股票相关数据,例如“AAPL 当前股价和日变化是多少?”或“微软(MSFT)的公司概览”。该工具需要 Python 3.10 或更高版本,并安装依赖后在 Claude Desktop 的 MCP 配置中添加 main.py 的绝对路径即可使用。项目灵感来自 Luigi Ajah 的 mcp-stocks 项目,但改为直接使用 MCP 库而非 FastAPI,并针对 Claude Desktop 进行了适配。

访问官网

工具介绍

用途

YFinance-Trader-MCP-ClaudeDesktop 是一个 MCP(模型上下文协议)工具,旨在为 Claude Desktop 提供股票市场数据与交易能力。它基于 yfinance 库获取数据,使用户能够通过自然语言查询实时股票信息、公司财务数据、历史价格、分析师推荐及内部交易等。

主要能力

该工具提供以下功能:

  • 实时股票报价:获取股票的实时报价信息,包括当前价格和日变化。
  • 公司信息与财务指标:获取公司概览和关键财务指标。
  • 历史价格数据:获取指定股票的历史每日价格数据。
  • 代码搜索:搜索股票及其他证券的代码。
  • 分析师推荐:获取股票的分析师推荐。
  • 内部交易跟踪:获取内部交易信息。

此外,还支持有限的加密货币数据,通过特殊代码格式(如 BTC-USD、ETH-USD、DOGE-USD)查询。

使用方式

  1. 环境要求:确保已安装 Python 3.10 或更高版本。
  2. 安装依赖:在项目目录中安装所需依赖。
  3. 集成到 Claude Desktop:在 Claude Desktop 的 MCP 配置中添加配置项,将路径替换为 main.py 文件的完整绝对路径。
  4. 重启 Claude Desktop:如有需要,重启 Claude Desktop 以加载配置。
  5. 使用工具:在 Claude Desktop 中通过自然语言提问,例如:
    • "What is the current stock price and daily change for AAPL?"
    • "Can you give me a company overview for Microsoft (MSFT)?"
    • "Show me the historical price data for Tesla (TSLA) over the last 3 months."
    • "Search for stocks related to 'NVDA'."
    • "What are the analyst recommendations for Amazon (AMZN)?"
    • "Have there been any recent insider transactions for Google (GOOGL)?"

可用工具

  • get_stock_quote:获取实时股票报价信息。
  • get_company_overview:获取公司信息与关键指标。
  • get_time_series_daily:获取历史每日价格数据。
  • search_symbol:搜索股票及其他证券。
  • get_recommendations:获取分析师推荐。
  • get_insider_transactions:获取内部交易信息。

适用场景

适用于需要通过 Claude Desktop 快速查询股票市场数据的用户,如投资者、分析师或对金融市场感兴趣的个人。可进行实时报价查询、公司基本面分析、历史价格回溯、股票代码搜索以及跟踪分析师观点和内部交易动态。

限制

  • 需要 Python 3.10 或更高版本。
  • 加密货币支持有限,仅限特定代码格式。
  • 所有工具包含错误处理,若出错将返回错误消息。
  • 若 MCP 服务器在 Claude Desktop 中不工作,可参考故障排除步骤:确保服务器运行、检查配置路径是否正确且为绝对路径、确保 Python 3.10+ 在系统 PATH 中、检查依赖安装、重启 Claude Desktop、查看日志错误信息。
  • 该项目与原始 mcp-stocks 项目的区别:直接使用 MCP 库而非 FastAPI、适配 Claude Desktop 而非 Cursor、修改了错误处理与响应格式、更新了配置方法。