💹 MCP YFinance 股票服务器

该项目建立了一个股票价格服务器，由 Yahoo Finance (YFinance) API 提供支持，并为与 MCP (多智能体控制协议) 的无缝集成而构建。

它允许 AI 代理或客户端：

• 检索实时股票数据
• 管理自选股列表
• 执行完整的股票分析
• 运行完整的技术指标
• 以及更多

---

🪙 简单开始：首先构建一个加密货币价格追踪器

在深入研究完整的股票服务器之前，我建议从这个用 Python + MCP 构建的简单加密货币追踪器开始 👇

🔗 GitHub 仓库： https://github.com/Adity-star/mcp-crypto-server

你将学习如何：

• 使用 MCP 公开加密货币工具，例如 get_price("BTC")
• 使用 FastAPI 构建 API
• 使用 Alpaca API 获取实时价格

---

📈 然后升级：构建 yFinance 股票服务器

一旦你熟悉了流程，就可以继续使用这个更高级的股票追踪器 💹

🔗 GitHub 仓库： https://github.com/Adity-star/mcp-yfinance-server

📝 详细博客： 👉 我如何使用 Python、yFinance 和一点书呆子的野心构建我自己的股票服务器

包括：

• 自选股列表
• 实时（ish）价格更新
• 技术摘要
• 功能齐全的仪表板
• 趋势 + 动量指标
• 自选股列表管理

---

📦 步骤 1：设置环境 (使用 uv)

我们使用 uv — 一个现代、超快的 Python 包管理器 — 来管理我们的项目环境。

🛠️ 安装和设置

在你的终端中运行以下命令：

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

# 创建并导航到你的项目目录
mkdir mcp-yfinance-server
cd mcp-yfinance-server

# 初始化一个新项目
uv init

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

📥 安装项目

一旦你的 pyproject.toml 设置了依赖项，运行：

# 运行
uv install .

---

🚀 步骤 2：运行 MCP 服务器

一旦你的环境准备就绪，启动股票服务器：

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

🧪 想要先进行快速测试？ 尝试运行轻量级演示服务器：

uv run demo_stock_price_server.py

📄 好奇完整的服务器如何工作？

在此处浏览源代码：

🔗 yf_server.py › GitHub

---

🛠️ MCP 工具参考

该服务器为 AI 代理和 CLI 用户公开了许多工具。 以下是一些重要的工具，请在此处查看完整的工具列表 here:

📦 工具列表

工具名称	描述
add_to_watchlist	将股票代码添加到你的个人自选股列表。
analyze_stock	执行为期 1 个月的技术趋势分析（RSI、MACD、MA）。
get_technical_summary	生成包含指标和信号的综合技术摘要。
get_watchlist_prices	获取所有自选股代码的最新价格。
get_trend_analysiss	分析最近的趋势变化、模式和背离。
get_stock_price	检索给定股票代码的当前价格。
get_volatility_analysis	计算历史波动率和 ATR 指标。
compare_stocks	比较两个股票价格（用于相对表现分析）。

✅ 总计：18 个强大的工具，可以精确地分析和监控股票。

🧠 用例

这些工具非常适合：

• 📊 动态自选股列表管理
• 🔁 趋势和动量检测
• 📈 用于投资决策的深入技术分析
• ⚠️ 基于波动率的风险评估
• 🤖 为以股票为中心的自主代理或仪表板提供动力

⚙️ 请随时参考此参考，以使用 MCP 服务器构建智能金融应用程序。

---

🔍 步骤 3：检查 MCP 服务器

使用 MCP Server Inspector 轻松浏览和测试你的 MCP 工具。 在你的终端中运行以下命令：

$ mcp dev source/yf_server.py

这将启动一个交互式 UI 以：

• 🧰 查看所有可用的工具和资源
• 📥 测试每个工具的输入/输出
• 📡 监控来自你的服务器的实时响应

---

⚙️ 步骤 4：配置你的 MCP 服务器

要集成你的 YFinance MCP 服务器，请将以下条目添加到你的 mcp.config.json 文件中：

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

⚠️ 将 /ABSOLUTE/PATH/TO/... 替换为实际文件路径。 💡 提示：将你的服务器从 crypto-price-tracker 重命名为 yfinance-price-tracker 以提高清晰度。

---

🔁 步骤 5：重启 Claude Desktop

重启 Claude Desktop（或任何使用 MCP 的界面）以重新加载并激活你的新 YFinance 工具。

这确保更新后的 MCP 配置被识别，并且所有股票跟踪工具都已准备好使用。

---

✅ 步骤 6：使用 Claude Desktop 测试 MCP 服务器

• 安装和配置好所有内容后，你就可以在 Claude Desktop 中测试你的 MCP 服务器了。

使用以下示例查询来测试你的 MCP YFinance 服务器的运行情况：

“比较特斯拉和苹果的股票价格。” → 🔧 使用 compare_stocks

“获取过去一个月特斯拉的历史数据。” → 📊 使用 get_stock_history

“将苹果、特斯拉和 Reliance 添加到我的自选股列表。” → 📋 使用 add_to_watchlist

“向我展示苹果过去 30 天的股票图表。” → 🖼️ Claude 可以使用你的服务器获取 + 可视化数据

📷 示例图表： 🖼 查看屏幕截图

🌐 Live Claude 站点： 在 Claude.site 上打开演示

🧪 这些测试确保你的 MCP 集成端到端地工作——从数据检索到实时分析和可视化。

---

📊 结果

⚙️ 你可以预期的结果

功能	结果
✅ 股票分析	分析股票，提供价格、OHLC、回报、交易量、见解和数据。
📈 技术分析	访问 RSI、MACD、MA 等指标以及完整的技术摘要。
📉 波动率报告	使用 ATR 和波动率指标分析股票风险。
🔍 趋势分析	使用价格变动分析检测趋势变化和背离。
🧠 可视化	18+ 个工具已准备好为 AI 代理或仪表板提供支持，以可视化股票。
📋 技术图表	实时分析和监控股票的技术指标。
🖼️ 视觉洞察	使用 Claude Desktop 生成图表和视觉摘要。

🎉 准备好构建你的股票跟踪机器人或智能金融仪表板了吗？ 该项目拥有所有核心部分。

---

📫 反馈和贡献

欢迎贡献！ 无论你是修复错误、添加功能还是改进文档，你的帮助都会使该项目变得更好。

🐛 报告问题

如果你遇到错误或有建议，请在 问题部分 中打开一个问题。 请务必包括：

• ✅ 重现步骤（如果适用）
• 🔍 预期行为与实际行为
• 📷 屏幕截图或错误日志（如果相关）

📬 提交拉取请求

有修复或改进吗？ 前往 拉取请求部分 并提交你的 PR。 我们将尽快审查并合并它！

---

💬 传播信息

如果该项目使你免于 API 速率限制或价格过高的 SaaS 工具...

• 🌟 Star 仓库
• 🍴 Fork 它并构建你自己的加密货币/股票工具
• 📲 在 X 上标记我 @AdityaAkuskar — 我很乐意看到你构建的东西！
• 🔗 在 LinkedIn 上与我联系

---

📜 许可证

MIT © 2025 Ak Aditya.

---

🚀 让我们一起构建更好的工具。

如果你想要一个关于此的推文线程、轮播或启动帖子 — 我会支持你 😎