Stock Price MCP Server

🚀 股票价格MCP服务器

这是一个基于FastMCP的股票价格查询服务器，可提供实时的股票市场数据。

✨ 主要特性

由yfinance提供支持，可获取实时股票数据：

• get_stock_price(symbol: str) - 获取实时股票价格及相关信息

  • 支持美国股票（如AAPL、GOOGL、TSLA、MSFT等）
  • 支持台湾股票（如2330.TW、2317.TW等）
  • 返回价格、涨跌幅、成交量、市值等信息

• get_stock_history(symbol: str, period: str) - 获取历史价格

  • 周期选项：1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max
  • 返回OHLCV（开盘价、最高价、最低价、收盘价、成交量）数据

• get_stock_info(symbol: str) - 获取详细的股票信息

  • 公司名称、行业、所在国家
  • 员工数量、市值、市盈率
  • 52周最高价/最低价等

• greet(name: str) - 问候工具

🚀 快速开始

🚀 快速部署到FastMCP云

步骤1：分叉或克隆此仓库

git clone https://github.com/YOUR_USERNAME/stock-price-mcp-server.git
cd stock-price-mcp-server

步骤2：推送到你的GitHub

git remote set-url origin https://github.com/YOUR_USERNAME/stock-price-mcp-server.git
git push -u origin main

步骤3：部署到FastMCP云

1. 访问 FastMCP云
2. 使用你的GitHub账户登录
3. 点击“创建新项目”
4. 填写项目信息：
   • 名称：stock-price-server（或你喜欢的名称）
   • GitHub仓库：选择你的仓库
   • 入口点：server.py:mcp
   • 认证方式：选择公开或仅组织内可见
5. 点击“部署”

步骤4：使用你的服务器

部署完成后，你的服务器将在以下地址可用：

https://your-project-name.fastmcp.app/mcp

你可以在Claude Desktop、Cursor或其他MCP客户端中连接此服务器。

💻 本地开发

要求

• Python 3.10 或更高版本
• uv（推荐）或pip
• FastMCP CLI

安装依赖

使用uv：

uv pip install -r requirements.txt

本地运行服务器

启动FastMCP开发服务器：

fastmcp dev server.py:mcp

服务器将在 http://localhost:8000 可用。

⚠️ 重要提示

不要使用 uv run server.py - FastMCP服务器必须通过 fastmcp CLI工具运行。

验证服务器配置

在不运行服务器的情况下检查配置：

fastmcp inspect server.py:mcp

测试服务器

启动服务器后，你可以在另一个终端中使用测试客户端进行测试：

uv run main.py

📈 支持的股票代码

美国股票

• AAPL - 苹果公司
• GOOGL - 字母表公司
• TSLA - 特斯拉公司
• MSFT - 微软公司
• NVDA - 英伟达公司
• META - Meta平台公司

台湾股票

• 2330.TW - 台积电
• 2317.TW - 鸿海精密
• 2454.TW - 联发科
• 2412.TW - 中华电信

其他市场

• 9988.HK - 阿里巴巴（香港）
• 600519.SS - 贵州茅台（上海）

💻 使用示例

在Claude Desktop中使用

1. 打开Claude Desktop设置
2. 添加MCP服务器：

{
  "mcpServers": {
    "stock-price": {
      "url": "https://your-project-name.fastmcp.app/mcp"
    }
  }
}

3. 重启Claude Desktop
4. 现在你可以询问：“AAPL的股票价格是多少？” 或 “显示台积电上个月的价格走势”

使用FastMCP客户端

import asyncio
from fastmcp import Client

async def query_stock():
    client = Client("https://your-project-name.fastmcp.app/mcp")
    async with client:
        # 查询实时股票价格
        result = await client.call_tool("get_stock_price", {"symbol": "AAPL"})
        print(result.data)

        # 查询历史价格
        history = await client.call_tool("get_stock_history", {
            "symbol": "TSLA",
            "period": "1mo"
        })
        print(history.data)

asyncio.run(query_stock())

🔧 技术细节

• 数据源：雅虎财经（通过yfinance包）
• 更新频率：实时（受雅虎财经API限制，有15分钟延迟）
• 支持的市场：主要全球股票市场（美国、台湾、香港、中国等）
• 部署平台：FastMCP云
• 自动部署：推送到主分支时自动重新部署
• PR预览：每个PR都有一个唯一的测试URL

📁 文件结构

stock-price-mcp-server/
├── server.py           # FastMCP服务器实现
├── requirements.txt    # Python依赖项
├── pyproject.toml      # 项目配置
├── .gitignore         # Git忽略规则
└── README.md          # 文档

📄 许可证

MIT许可证

🤝 贡献

欢迎提交问题和拉取请求！

🛠️ 支持

如有疑问：

1. 查看 FastMCP官方文档
2. 提交GitHub问题
3. 访问 FastMCP云 获取帮助