YFinance Trader MCP 工具

这是一个使用 yfinance 库提供股市数据和交易功能的 MCP（模型上下文协议）工具。

特性

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

安装

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

2. 安装依赖项：

pip install -r requirements.txt
# 或使用 pyproject.toml
pip install .

与 Cursor 集成

1. 在 Cursor 中，进入设置 > MCP
2. 点击 "+ 添加新 MCP 服务器"
3. 填写表单：
   • 名称： "yfinance-trader"（或您喜欢的任何名称）
   • 命令：python3 /path/to/your/yfinance-trader/main.py

示例命令：

python3 /Users/username/projects/yfinance-trader/main.py

（替换为您实际的 main.py 路径）

4. 点击“添加”并根据需要重启 Cursor

可用工具

1. get_stock_quote

获取实时股票报价信息：

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

2. get_company_overview

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

{
    "name": "苹果公司",
    "sector": "科技",
    "industry": "消费电子",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. get_time_series_daily

获取历史每日价格数据：

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

4. search_symbol

搜索股票和其他证券：

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "苹果公司",
            "type": "EQUITY",
            "exchange": "纳斯达克"
        }
        // ... 更多结果
    ]
}

5. get_recommendations

获取股票分析师推荐：

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

6. get_insider_transactions

获取内部交易信息：

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "约翰·杜",
            "position": "董事",
            "transactionType": "购买",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "购买了1000股",
            "startDate": "2024-03-15",
            "ownership": "直接"
        }
        // ... 更多交易
    ]
}

错误处理

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

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

故障排除

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

1. 验证设置中的路径是否正确且为绝对路径
2. 确保系统 PATH 中有 Python 3.10+
3. 检查所有依赖项是否已安装
4. 尝试重启 Cursor
5. 查看 Cursor 的日志以查找任何错误消息

许可证

MIT 许可证