Yfinance Trader

🚀 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