YFinance交易员MCP工具

一个使用yfinance库提供股票市场数据和交易功能的模型上下文协议（Model Context Protocol）工具。

功能

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

安装配置

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": "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. get_time_series_daily

获取历史每日价格数据：

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 150.00
        }
    ]
}

4. get_stock_search

根据关键词搜索股票：

{
    "search_term": "Apple",
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "exchange": "NASDAQ"
        },
        {
            "symbol": "APPL",
            "name": "Applied Materials Inc.",
            "exchange": "NASDAQ"
        }
    ]
}

5. get_insider_trading

获取内幕交易信息：

{
    "symbol": "AAPL",
    "insider_trading": [
        {
            "name": "Tim Cook",
            "position": "CEO",
            "transaction_type": "Buy",
            "shares": 1000,
            "price": 150.25,
            "date": "2024-03-15"
        }
    ]
}

错误处理

{
    "error": {
        "code": 404,
        "message": "股票代码不存在或无法找到数据"
    }
}

故障排除

1. 检查网络连接，确保可以访问互联网
2. 确保所有依赖项已正确安装
3. 尝试重新启动服务
4. 查看日志文件获取更多信息

许可证

MIT License