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. "苹果公司的当前股价是多少？"
2. "苹果公司和谷歌之间的股价差异是多少？"
3. "苹果公司在2025年1月1日至2025年3月31日之间的股价变化了多少？"

可视化请求

1. "生成一个展示主要指数表现的市场情绪仪表盘。"
2. "创建一个包含科技股AAPL、MSFT、GOOGL、AMZN和NVDA的投资组合跟踪报告。"
3. "显示特斯拉股票的移动平均线和支持/阻力水平的技术分析图。"
4. "生成一个包含S&P 500、道琼斯和纳斯达克的市场情绪仪表盘。"
5. "你能为我的能源股XOM、CVX、BP、COP和SLB创建一个投资组合报告吗？"
6. "我需要一份详细的NVDA股票技术分析报告，显示RSI和成交量模式。"

测试

要测试可视化功能：

cd tests
python test_visualization.py

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

许可证

本项目采用MIT许可证——详情见LICENSE文件。

致谢

• 原始项目由Max Scheijen提供
• 受tooyipjee启发，增加了可视化能力