YFinance Trader MCP 工具用于 Claude Desktop

这是一个使用 yfinance 库提供股市数据和交易能力的 MCP（模型上下文协议）工具，特别针对 Claude Desktop 进行了适配。

致谢：本项目灵感来源于 mcp-stocks，由 Luigi Ajah 开发，这是一个针对 Cursor 的类似实现。此改编版修改了原始概念以适应 Claude Desktop。

教程

有关设置和使用此工具的详细指南，请参阅我们的 Medium 教程： 教程：使用 Claude Desktop 和 YFinance Trader MCP 工具访问实时股票市场数据

功能

• 实时股票报价
• 公司信息和财务指标
• 历史价格数据
• 股票代码搜索功能
• 分析师推荐
• 内部交易跟踪

设置

1. 确保已安装 Python 3.10 或更高版本

2. 安装依赖项：

pip install -r requirements.txt

与 Claude Desktop 集成

1. 在 Claude Desktop 中配置您的 MCP 设置，添加以下内容到您的 MCP 配置中：

{
  "mcpServers": {
    "yfinance-trader": {
      "command": "py",
      "args": ["-3.13", "path/to/your/main.py"]
    }
  }
}

2. 将路径替换为您 main.py 文件的完整路径
3. 如有需要，请重启 Claude Desktop

可用工具

1. 获取股票报价

获取实时股票报价信息：

{
    "symbol": "AAPL",
    "price": 150.25,
    "change": 2.5,
    "changePercent": 1.67,
    "volume": 1234567,
    "timestamp": "2024-03-20T10:30:00"
}

2. 获取公司概况

获取公司信息和关键指标：

{
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. 获取每日时间序列

获取历史每日价格数据：

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 151.75,
            "volume": 12345678
        }
        // ... 更多数据点
    ]
}

4. 搜索股票代码

搜索股票和其他证券：

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... 更多结果
    ]
}

5. 获取分析师推荐

获取股票的分析师推荐：

{
    "symbol": "AAPL",
    "recommendations": [
        {
            "period": "2024-03-15T00:00:00",
            "strongBuy": 15,
            "buy": 20,
            "hold": 8,
            "sell": 2,
            "strongSell": 0
        }
        // ... 更多时期
    ]
}

6. 获取内部交易信息

获取内部交易信息：

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "John Doe",
            "position": "Director",
            "transactionType": "Buy",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "购买了1000股",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... 更多交易
    ]
}

示例查询

您可以向 Claude Desktop 提问如下问题：

• "AAPL 当前股价及日变化是多少？"
• "能否给我提供微软 (MSFT) 的公司概况？"
• "显示特斯拉 (TSLA) 最近三个月的历史价格数据。"
• "搜索与 'NVDA' 相关的股票。"
• "亚马逊 (AMZN) 的分析师推荐是什么？"
• "谷歌 (GOOGL) 是否有任何最近的内部交易？"

加密货币支持

使用特殊代码格式可以获取有限的加密货币数据：

• BTC-USD 用于比特币
• ETH-USD 用于以太坊
• DOGE-USD 用于狗狗币

错误处理

所有工具都包括适当的错误处理，并在出现问题时返回错误消息：

{
    "error": "无法获取 INVALID_SYMBOL 的报价"
}

故障排除

如果 MCP 服务器在 Claude Desktop 中不起作用：

1. 确保服务器正在运行 - 启动脚本时应看到输出
2. 验证设置中的路径是否正确且为绝对路径
3. 确保系统 PATH 中有 Python 3.10+
4. 检查所有依赖项是否已安装
5. 尝试重启 Claude Desktop
6. 查看日志是否有任何错误消息

与原始 mcp-stocks 项目的区别

• 直接使用 MCP 库而不是 FastAPI
• 适配 Claude Desktop 而不是 Cursor
• 修改了错误处理和响应格式
• 更新了配置方法

许可证

MIT 许可证