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雲 獲取幫助