用途
YFinance-Trader-MCP-ClaudeDesktop 是一个 MCP(模型上下文协议)工具,旨在为 Claude Desktop 提供股票市场数据与交易能力。它基于 yfinance 库获取数据,使用户能够通过自然语言查询实时股票信息、公司财务数据、历史价格、分析师推荐及内部交易等。
主要能力
该工具提供以下功能:
- 实时股票报价:获取股票的实时报价信息,包括当前价格和日变化。
- 公司信息与财务指标:获取公司概览和关键财务指标。
- 历史价格数据:获取指定股票的历史每日价格数据。
- 代码搜索:搜索股票及其他证券的代码。
- 分析师推荐:获取股票的分析师推荐。
- 内部交易跟踪:获取内部交易信息。
此外,还支持有限的加密货币数据,通过特殊代码格式(如 BTC-USD、ETH-USD、DOGE-USD)查询。
使用方式
- 环境要求:确保已安装 Python 3.10 或更高版本。
- 安装依赖:在项目目录中安装所需依赖。
- 集成到 Claude Desktop:在 Claude Desktop 的 MCP 配置中添加配置项,将路径替换为 main.py 文件的完整绝对路径。
- 重启 Claude Desktop:如有需要,重启 Claude Desktop 以加载配置。
- 使用工具:在 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、修改了错误处理与响应格式、更新了配置方法。