股票交易数据工具

一个使用yfinance库提供股票市场数据和交易功能的MCP工具,适用于金融分析和交易策略开发。

  • by luigiajah
  • Python
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 luigiajah/mcp-stocks

使用说明

YFinance交易员MCP工具

一种MCP(模型上下文协议)工具,使用yfinance库提供股票市场数据和交易功能。

特性

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

设置

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

  2. 安装依赖项:

pip install -r requirements.txt
# or using pyproject.toml
pip install .

与Cursor集成

  1. 在光标中,转到设置>MCP
  2. 点击“+添加新MCP服务器”
  3. 填写表格:
    • 名称:“e金融交易员”(或您喜欢的任何名称)
    • 命令: python3 /path/to/your/yfinance-trader/main.py

命令示例:

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

(替换为指向main.py的实际路径)

  1. 如果需要,单击“添加”并重新启动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.公司概述

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

{
    "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
        }
        // ... more data points
    ]
}

4.搜索_符号

搜索股票和其他证券:

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... more results
    ]
}

5.获得表彰

获取分析师对股票的建议:

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

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": "Purchase of 1000 shares",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... more transactions
    ]
}

错误处理

所有工具都包含正确的错误处理,如果出现错误,将返回错误消息:

{
    "error": "Failed to fetch quote for INVALID_SYMBOL"
}

故障排除

如果MCP服务器在Cursor中不工作:

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

许可证

MIT许可证