使用说明
YFinance Trader MCP工具克劳德桌面版
一种MCP（模型上下文协议）工具，使用特别适用于Claude Desktop的yfinance库提供股票市场数据和交易功能。
信用：该项目的灵感来自 mcp股票 由Luigi Ajah编写，这是Cursor的类似实现。这种改编修改了原始概念，使其与Claude Desktop兼容。
教程
有关设置和使用此工具的详细指南，请查看我们的Medium教程： 教程：使用克劳德桌面与YFinance Trader MCP工具访问实时股市数据
特性
- 实时股票报价
- 公司信息和财务指标
- 历史价格数据
- 符号搜索功能
- 分析师建议
- 内幕交易追踪
设置
-
确保您安装了Python 3.10或更高版本
-
安装依赖项：
pip install -r requirements.txt
与Claude Desktop集成
- 通过在MCP配置中添加以下内容，在Claude Desktop中配置MCP设置：
{
"mcpServers": {
"yfinance-trader": {
"command": "py",
"args": ["-3.13", "path/to/your/main.py"]
}
}
}
- 将路径替换为main.py文件的完整路径
- 如果需要，请重新启动Claude Desktop
可用工具
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
]
}
示例查询
您可以向Claude Desktop提出以下问题：
- “AAPL目前的股价和每日变化是多少？”
- “你能给我介绍一下微软（MSFT）的公司概况吗？”
- “给我看看特斯拉（TSLA）过去3个月的历史价格数据。”
- “搜索与‘NVDA’相关的股票。”
- “分析师对亚马逊（AMZN）有什么建议？”
- “谷歌（GOOGL）最近有内幕交易吗？”
加密货币支持
使用特殊的股票代码格式可以获得有限的加密货币数据：
- BTC-USD 为 比特币
- 以太坊的ETH-USD
- DOGE-USD兑换狗狗币
错误处理
所有工具都包含正确的错误处理，如果出现错误，将返回错误消息：
{
"error": "Failed to fetch quote for INVALID_SYMBOL"
}
故障排除
如果MCP服务器在Claude Desktop中不工作：
- 确保服务器正在运行-启动脚本时应该会看到输出
- 验证设置中的路径是否正确且绝对
- 确保Python 3.10+在您的系统PATH中
- 检查是否安装了所有依赖项
- 尝试重新启动Claude Desktop
- 检查日志中是否有任何错误消息
与原始mcp股票项目的差异
- 直接使用MCP库而不是FastAPI
- 适用于Claude Desktop而不是Cursor
- 修改了错误处理和响应格式
- 更新的配置方法
许可证
MIT许可证
