💹 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 获取实时价格

🔗 相关项目

探索我的更多作品：

• GenAI-Learnings：深入了解生成式AI的概念、工具和项目。
• LangChain-Mastery：掌握 LangChain 所需的一切，用于构建强大的LLM应用程序。
• Complete Data Science：深入了解数据科学AI的概念、工具和项目，以及所有学习和面试准备材料。
• Reinforcement-Learning：强化学习的手动实验和理论。
• CompleteRAG：检索增强生成(RAG)系统的端到端实现。

---

📈 然后提升水平：构建 yFinance 股票服务器

一旦熟悉了流程，就可以转向这个更高级的股票追踪器 💹

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

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

包括：

• 观察列表
• 实时（或接近实时）价格更新
• 技术总结
• 功能齐全的仪表板
• 趋势 + 动量指标
• 观察列表管理

---

📦 第一步：设置环境（使用 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 pip install -e .

---

🚀 第二步：运行 MCP 服务器

一旦您的环境准备好，启动股票服务器：

uv run main.py

🧪 想先快速测试一下吗？ 尝试检查工具：

python run test_server_fun.py

📄 对整个服务器的工作原理感兴趣？

在这里探索源代码：

🔗 yf_server.py › GitHub

---

🛠️ MCP 工具参考

该服务器为AI代理和CLI用户暴露了许多工具。 这里是一些重要的工具，查看完整的工具列表 这里：

📦 工具列表

工具名称	描述
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	比较两个股票的价格（对于相对性能分析很有用）。

✅ 总共：18个强大的工具，用于精确分析和监控股票。

🧠 使用案例

这些工具非常适合：

• 📊 动态观察列表管理
• 🔁 趋势和动量检测
• 📈 深入的技术分析以做出投资决策
• ⚠️ 基于波动性的风险评估
• 🤖 支持专注于股票的自主代理或仪表板

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

---

🔍 第三步：检查 MCP 服务器

使用 MCP 服务器检查器 轻松探索和测试您的 MCP 工具。 在您的终端中运行以下命令：

$ mcp dev source/yf_server.py

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

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

---

⚙️ 第四步：配置您的 MCP 服务器

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

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

⚠️ 用实际文件路径替换 /ABSOLUTE/PATH/TO/... 💡 提示：为了清晰起见，将您的服务器从 crypto-price-tracker 重命名为 yfinance-price-tracker。

---

🔁 第五步：重启 Claude Desktop

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

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

---

✅ 第六步：使用 Claude Desktop 测试 MCP 服务器

• 安装和配置完成后，您就可以在 Claude Desktop 中测试您的 MCP 服务器了。

使用以下示例查询来测试您的 MCP YFinance 服务器：

"比较特斯拉和苹果的股价。" → 🔧 使用 compare_stocks

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

"将苹果、特斯拉和Reliance添加到我的观察列表。" → 📋 使用 add_to_watchlist

"显示过去30天内苹果股票的图表。" → 🖼️ Claude 可以使用您的服务器获取并可视化数据

📷 示例图表： 🖼 查看截图

🌐 实时 Claude 网站： 在 Claude.site 上打开演示

🧪 这些测试确保您的 MCP 集成从数据检索到实时分析和可视化都能正常工作。

---

📊 结果

⚙️ 您可以期待的结果

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

🎉 准备构建您的股票跟踪机器人或智能财务仪表板了吗？这个项目包含了所有核心组件。

---

📫 反馈与贡献

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

🐛 报告问题

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

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

📬 提交拉取请求

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

---

💬 传播消息

如果这个项目帮您避免了API速率限制或昂贵的SaaS工具...

• 🌟 点赞 该仓库
• 🍴 分叉 它并构建您自己的加密货币/股票工具
• 📲 在X上标记我 @AdityaAkuskar — 我很乐意看到您构建的内容！
• 🔗 在 LinkedIn 上联系我

---

📜 许可证

MIT © 2025 Ak Aditya。

---

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