💹 MCP YFinance Stock Server

💹 MCP YFinance Stock Server

site icon
2025.04.15 2
Python股票服务金融分析金融服务
MCP YFinance Stock Server 是一个基于 Yahoo Finance (YFinance) API 的股票价格服务器,专为与 MCP (Multi-Agent Control Protocol) 无缝集成而设计。它允许 AI 代理或客户端检索实时股票数据、管理观察列表、执行完整的股票分析、运行技术指标等。
View on GitHub

Overview

基本能力

产品定位

MCP YFinance Stock Server 是一个股票价格服务器,旨在为 AI 代理或客户端提供实时股票数据和分析工具。

核心功能

  • 检索实时股票数据
  • 管理观察列表
  • 执行完整的股票分析
  • 运行技术指标
  • 生成技术摘要
  • 分析趋势和动量
  • 计算波动性指标
  • 比较股票价格

适用场景

  • 动态观察列表管理
  • 趋势和动量检测
  • 深入技术分析用于投资决策
  • 基于波动性的风险评估
  • 为股票聚焦的自主代理或仪表板提供支持

工具列表

工具名称 描述
add_to_watchlist 将股票代码添加到个人观察列表
analyze_stock 执行一个月的技术趋势分析(RSI, MACD, MAs)
get_technical_summary 生成包括指标和信号的全面技术摘要
get_watchlist_prices 获取观察列表中所有股票的最新价格
get_trend_analysiss 分析最近的趋势变化、模式和分歧
get_stock_price 检索给定股票代码的当前价格
get_volatility_analysis 计算历史波动性和 ATR 指标
compare_stocks 比较两只股票的价格(用于相对性能分析)

常见问题解答

  • 如何安装和设置环境?
  • 如何启动 MCP 服务器?
  • 如何测试服务器功能?
  • 如何配置 MCP 服务器?
  • 如何重启 Claude Desktop 以激活新工具?

使用教程

使用依赖

安装 uv(一个现代的、超快的 Python 包管理器)来管理项目环境。

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh 

# Create and navigate to your project directory
mkdir mcp-yfinance-server
cd mcp-yfinance-server

# Initialize a new project
uv init

# Create and activate the virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

安装教程

# Run 
uv install .

调试方式

启动股票服务器:

cp ../yf_serve.py .
uv run source/yf_server.py

快速测试:

uv run demo_stock_price_server.py

检查 MCP 服务器:

$ mcp dev source/yf_server.py

配置 MCP 服务器:

{
  "mcpServers": {
    "yfinance-price-tracker": {
      "command": "/ABSOLUTE/PATH/TO/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/YOUR/mcp-yfinance-server",
        "run",
        "yf_server.py"
      ]
    }
  }
}

重启 Claude Desktop 以激活新工具。

测试 MCP 服务器:

  • "Compare the stock prices of Tesla and Apple."
  • "Get the historical data for Tesla over the past month."
  • "Add Apple, Tesla, and Reliance to my watchlist."
  • "Show me a chart of Apple’s stock over the last 30 days."

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。