🚀 YFinance交易员MCP工具

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