Yfinance Trader

🚀 YFinance交易员MCP工具

YFinance交易员MCP工具是一款借助yfinance库，为用户提供股票市场数据和交易功能的模型上下文协议（Model Context Protocol）工具。它能帮助用户获取实时股票报价、公司信息、历史价格数据等，为股票交易决策提供有力支持。

🚀 快速开始

在使用该工具前，请完成以下安装配置步骤，然后将其集成到Cursor中。

✨ 主要特性

• 实时股票报价：随时获取最新的股票价格信息。
• 公司信息及财务指标：全面了解公司的基本情况和财务状况。
• 历史价格数据：分析股票的历史走势。
• 股票代码搜索功能：根据关键词快速查找股票。
• 内幕交易追踪：掌握公司内部人员的交易动态。

📦 安装指南

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。