Yahoo finance MCP server

MCP Yahoo Finance

一个用于与 Yahoo Finance 交互的 Model Context Protocol（MCP）服务。此服务提供用于获取价格、公司信息和生成金融可视化内容的工具。

本项目是 maxscheijen/mcp-yahoo-finance 的分支和扩展版本，新增了可视化功能。

功能

• 金融数据：获取当前股价、历史价格、股息、损益表等
• 可视化分析：生成精美的可视化内容，用于分析市场情绪、跟踪投资组合和进行技术分析
• 轻松集成：可与 Claude Desktop、VS Code、Cursor 及其他 MCP 客户端配合使用

设置说明

1. 克隆仓库

将此仓库克隆到本地计算机：

git clone https://github.com/leoncuhk/mcp-yahoo-finance.git
cd mcp-yahoo-finance

2. 安装依赖项

使用 pip 安装所需的依赖项：

pip install -r requirements.txt

如果缺少 requirements.txt 文件，也可以直接安装依赖项：

pip install mcp yfinance pandas matplotlib seaborn plotly kaleido numpy pillow base64io

3. 配置 MCP 客户端

Claude Desktop

将以下内容添加到 claude_desktop_config.json（如果文件不存在，请创建）：

• macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

你也可以使用 docker：

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "IMAGE"]
        }
    }
}

VSCode

将以下内容添加到 .vscode/mcp.json：

{
    "servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

Cursor

将以下内容添加到 Cursor MCP 配置中：

{
    "mcp-servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

4. 重启 MCP 客户端

完成配置后，重启 Claude Desktop 或你偏好的 MCP 客户端，以加载服务。

可用工具

基础金融数据

• get_current_stock_price：获取某个股票代码的当前股价
• get_stock_price_by_date：获取指定日期的股价
• get_stock_price_date_range：获取指定日期范围内的股价
• get_historical_stock_prices：获取可自定义时间段的历史股票数据
• get_dividends：获取股票的股息信息
• get_income_statement：获取损益表数据
• get_cashflow：获取现金流量表数据
• get_earning_dates：获取财报日期信息
• get_news：获取某只股票的近期新闻

可视化工具

• generate_market_dashboard：创建市场情绪仪表板，展示实时指数表现
• generate_portfolio_report：生成投资组合表现跟踪报告
• generate_stock_technical_analysis：创建股票技术分析报告

可视化示例

市场情绪仪表板

投资组合跟踪

股票技术分析

示例提示词

以下是一些可以尝试用于 Claude 的示例提示词：

基础金融数据

1. “Apple 当前的股价是多少？”
2. “Apple 和 Google 的股价有什么差异？”
3. “Apple 的股价在 2025-01-01 至 2025-3-31 期间变动了多少？”

可视化请求

1. “生成市场情绪仪表板，展示主要指数的表现。”
2. “为科技股 AAPL、MSFT、GOOGL、AMZN 和 NVDA 创建投资组合跟踪报告。”
3. “为 Tesla 股票绘制技术分析图表，显示移动平均线和支撑位／阻力位。”
4. “生成包含 S&P 500、Dow Jones 和 NASDAQ 的市场情绪仪表板。”
5. “能否为我的能源股 XOM、CVX、BP、COP 和 SLB 创建投资组合报告？”
6. “我需要一份 NVDA 股票的详细技术分析，显示 RSI 和成交量形态。”

测试

要测试可视化功能：

cd tests
python test_visualization.py

这将在 examples 目录中生成可视化示例图片。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

致谢

• 原始项目由 Max Scheijen 创建
• 受 tooyipjee 启发，扩展了可视化功能