🚀 YFinance交易员MCP工具
YFinance交易员MCP工具是一款借助yfinance库，为用户提供股票市场数据和交易功能的模型上下文协议（Model Context Protocol）工具。它能帮助用户获取实时股票报价、公司信息、历史价格数据等，为股票交易决策提供有力支持。
🚀 快速开始
在使用该工具前，请完成以下安装配置步骤，然后将其集成到Cursor中。
✨ 主要特性
- 实时股票报价：随时获取最新的股票价格信息。
- 公司信息及财务指标：全面了解公司的基本情况和财务状况。
- 历史价格数据：分析股票的历史走势。
- 股票代码搜索功能：根据关键词快速查找股票。
- 内幕交易追踪：掌握公司内部人员的交易动态。
📦 安装指南
- 确保已安装Python 3.10或更高版本。
- 安装依赖项：
pip install -r requirements.txt
# 或使用 pyproject.toml
pip install .
📚 详细文档
与Cursor的集成
- 在Cursor中，进入设置 > MCP。
- 点击“+ 添加新的MCP服务器”。
- 填写表单：
- 名称： "yfinance-trader"（或任何你选择的名字）
- 命令：
python3 /path/to/your/yfinance-trader/main.py
示例命令：
python3 /Users/username/projects/yfinance-trader/main.py
（请将路径替换为你实际的main.py路径）
- 点击“添加”并根据需要重启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": "股票代码不存在或无法找到数据"
}
}
故障排除
- 检查网络连接，确保可以访问互联网。
- 确保所有依赖项已正确安装。
- 尝试重新启动服务。
- 查看日志文件获取更多信息。
📄 许可证
本项目采用MIT License。