MCP Yfinance Server

💹 MCP YFinance 股票服务器

这个项目建立了 股票价格服务器 由……提供动力/支持 雅虎财经（YFinance） API，并且构建为可与（其他系统）无缝集成 MCP（模型控制协议）。

它允许人工智能代理或客户端：

• 获取实时股票数据
• 管理观察名单
• 进行全面库存分析
• 运行完整的技术指标
• 以及更多

______________________________________________________________________

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

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

🔗 GitHub 仓库: https://github.com/Adity-star/mcp-crypto-server 翻译为中文可以是：“https://github.com/Adity-star/mcp-加密服务器” 或者更流畅地表达为：“GitHub上的Adity-star/mcp-加密服务器项目”。不过，为了更贴近原文的表述风格，直接翻译为“GitHub上的Adity-star/mcp-crypto-server（加密服务器）”也是可以接受的。在实际应用中，通常会根据上下文和读者的背景选择最合适的表述方式

你将学会如何： - 使用MCP来暴露加密货币工具，如get_price("BTC") - 使用FastAPI构建一个API - 使用Alpaca API获取实时价格

🔗 相关项目

探索更多我的作品：

• 生成式人工智能学习成果深入探讨生成式人工智能的概念、工具和项目。
• 掌握LangChain掌握LangChain，构建强大的大型语言模型（LLM）应用所需的一切。
• 完整的数据科学深入探索数据科学与人工智能的概念、工具、项目，以及所有用于学习和面试准备的资料。
• 强化学习强化学习中的动手实验与理论学习。
• CompleteRAG端到端实现检索增强生成（RAG）系统。

______________________________________________________________________

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

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

🔗 GitHub 仓库：

📝 详细博客： 👉 我如何用Python、yFinance和一丝书呆子般的雄心壮志搭建自己的股票服务器

包括： - 监控名单 - 实时（近乎实时）价格更新 - 技术摘要 - 功能齐全的仪表盘 - 趋势+动量指标 - 观察名单管理

______________________________________________________________________

📦 步骤1：设置环境（使用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

📥 安装项目

一旦您的 \pyproject.toml\ 已设置依赖项，请运行：

#  Run 
uv pip install -e .

______________________________________________________________________

🚀 步骤2：运行MCP服务器

一旦您的环境准备就绪，启动库存服务器：

uv run main.py

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

python run test_server_fun.py

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

在此查看源代码：

🔗（链接符号，无具体含义，可理解为“链接”或“链接在此”）

______________________________________________________________________

🛠️ MCP 工具参考

服务器为AI代理和CLI用户提供了许多工具。\ 以下是一些重要的工具，请查看完整的工具列表 在这里:

📦 工具列表

✅（对号，表示正确、确认或完成） 总计：18款强大工具，精准分析与监控股票。

🧠 使用场景

这些工具非常适合用于：

• 📊 动态监控列表管理
• 🔁 趋势和动量检测
• 📈 投资决策中的深入技术分析
• ⚠️ 基于波动性的风险评估
• 为专注于库存的自主代理或仪表板提供动力

⚙️ 请妥善保存此参考信息，以便使用MCP服务器构建智能金融应用程序。

______________________________________________________________________

🔍 步骤3：检查MCP服务器

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

$ mcp dev source/yf_server.py

这会启动一个交互式用户界面，用于：

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

-

______________________________________________________________________

⚙️ 第四步：配置您的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。

______________________________________________________________________

🔁 步骤5：重启Claude桌面应用

重启 Claude Desktop（可译为“克劳德桌面版”或根据具体语境简化为“克劳德桌面”） （或任何使用MCP的接口）来重新加载并激活您的新YFinance工具。

这确保了更新后的MCP配置被识别，并且所有库存追踪工具都 准备就绪，可随时使用。

______________________________________________________________________

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

• 安装并配置好所有内容后，您就可以开始测试您的MCP服务器了 Claude Desktop（可译为“Claude桌面版”）。

使用这些示例查询来测试您的MCP YFinance服务器的实际运行情况：

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

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

“将苹果、特斯拉和信实工业添加到我的关注列表中。” → 📋 用途 add_to_watchlist

“给我看一下过去30天苹果股票的走势图。” → 🖼️ Claude 可以使用您的服务器获取并可视化数据

📷 示例图表： 🖼（图片） 查看截图

🌐 Claude 现场直播网站： 在Claude.site上开启演示

🧪 这些测试确保您的MCP（可能指某种系统或平台的缩写）集成能够实现端到端的正常运行，涵盖从数据检索到实时分析和可视化的全过程。

______________________________________________________________________

📊 结果

⚙️ 您可期待的结果

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

______________________________________________________________________

📮 反馈与贡献

欢迎贡献！无论你是修复漏洞、添加功能，还是改进文档，你的帮助都能让这个项目变得更好。

🐛 报告问题

如果您遇到错误或有任何建议，请在（项目/软件的）问题追踪系统中提交一个议题 问题部分务必包含：

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

📬 提交拉取请求

有修复或改进意见吗？请前往 “Pull Requests”部分 然后提交你的拉取请求（PR）。我们会尽快审核并合并它！

______________________________________________________________________

💬 传播开来

如果这个项目帮你摆脱了API速率限制或高昂的SaaS工具费用。。。

• 🌟 星星 该存储库
• 🍴 对应的中文翻译是“餐具”或“餐盘”。 叉 并开发你自己的加密货币/股票工具
• 📲 这个表情符号通常代表“手机”或“短信”，在中文中可以翻译为“📱（手机/短信）”。不过，直接使用表情符号本身在中文语境中也是被广泛接受的，所以根据上下文，有时也可以直接保留📲。 在X上标记我 @阿迪蒂亚·阿库斯卡尔 — 我很想看看你建造的东西！
• 🔗（此符号在中文中通常表示链接，但无具体含义需结合上下文） 在（某个平台）上与我联系 LinkedIn（领英）

______________________________________________________________________

📜 许可证

麻省理工学院 © 2025 Ak Aditya。

______________________________________________________________________

🚀 让我们一起打造更好的工具。

如果你想要一条推文系列、轮播图或者发布帖子来展示这个——我来帮你搞定😎