Skip to content

Latest commit

 

History

History
190 lines (135 loc) · 5.18 KB

README_cn.md

File metadata and controls

190 lines (135 loc) · 5.18 KB

MCP Yahoo Finance

一个用于 Yahoo Finance 交互的 Model Context Protocol (MCP) 服务器。该服务器提供了获取价格、公司信息和生成金融可视化的工具。

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

功能特点

  • 金融数据：获取当前股票价格、历史价格、股息、收益报表等
  • 可视化分析：生成美观的市场情绪、投资组合跟踪和技术分析可视化图表
  • 轻松集成：与 Claude Desktop、VS Code、Cursor 和其他 MCP 客户端兼容

安装

如果你使用 uv，你无需手动安装 mcp-yahoo-finance。我们将使用 uvx 直接运行 mcp-yahoo-finance。

pip install mcp-yahoo-finance

使用 Git

你也可以在克隆仓库到你的机器后安装此包。

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

配置

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

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

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"]
        }
    }
}

可用工具

基础金融数据

  • 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. "苹果股票在 2023-01-01 到 2023-12-31 之间的价格变化了多少？"

可视化请求

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

运行测试

要测试可视化功能：

cd tests
python test_visualization.py

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

使用 MCP Inspector 测试

npx @modelcontextprotocol/inspector uv run mcp-yahoo-finance

使用示例提示语

现在用户可以通过Claude使用以下提示语来生成可视化：

1. **市场情绪分析仪表板**:

请生成一个市场情绪分析仪表板，展示S&P 500、道琼斯和纳斯达克的实时表现和恐惧/贪婪指标。


2. **投资组合表现跟踪**:

请创建一个技术股投资组合的表现跟踪报告，包括AAPL、MSFT、GOOGL、AMZN和NVDA。


3. **股票技术分析**:

请对特斯拉(TSLA)股票进行技术分析，展示价格趋势、移动平均线、支撑位和阻力位。


4. **自定义指数的市场情绪分析**:

请生成一个市场情绪分析仪表板，展示指数^FTSE,^N225,^HSI的实时表现。


5. **自定义股票的投资组合跟踪**:

请创建一个能源股投资组合的表现跟踪报告，包括XOM,CVX,BP,COP,SLB。


6. **自定义股票的技术分析**:

请对英伟达(NVDA)股票进行技术分析，展示价格趋势、RSI和交易量模式。

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢