Stock Price

股票价格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

第二步：推送到你的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 - 认证：仅选择公共或组织

1. 点击“部署”

步骤4：使用您的服务器

部署后，您的服务器将在以下位置可用：

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

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

地方发展

需求

• Python 3.10或更高版本
• uv（推荐）或pip
• FastMCP命令行界面

再进行

使用紫外线：

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-苹果股份有限公司。
• 谷歌-Alphabet股份有限公司。
• TSLA-特斯拉股份有限公司。
• 微软公司
• NVDA-英伟达公司
• META-META平台股份有限公司。

台湾股市

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

其他市场

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

用法示例

在Claude桌面中使用

1. 打开克劳德桌面设置
2. 添加MCP服务器：

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

1. 重新启动克劳德桌面
2. 现在你可以问：“苹果公司的股价是多少？”或“给我看看台积电上个月的价格走势”

使用FastMCP客户端

import asyncio
from fastmcp import Client

async def query_stock():
    client = Client("https://your-project-name.fastmcp.app/mcp")
    async with client:
        # Query real-time stock price
        result = await client.call_tool("get_stock_price", {"symbol": "AAPL"})
        print(result.data)

        # Query historical prices
        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 server implementation
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project configuration
├── .gitignore         # Git ignore rules
└── README.md          # Documentation

许可证

MIT许可证

贡献

欢迎问题和拉取请求！

支持

如有疑问：

1. 检查 FastMCP官方文档
2. 提交GitHub问题
3. 访问 FastMCP云 求助