MCP Stock Market

🚀 MCP 股票市場

MCP 股票市場是一款藉助 Alpha Vantage API 獲取股票市場數據的模型上下文協議 (MCP) 工具。它能讓用戶通過簡潔的 MCP 接口，輕鬆訪問任意股票代碼的每日股票市場數據。

🚀 快速開始

MCP 股票市場工具可幫助您便捷地獲取股票市場數據，以下是使用前的準備工作。

✨ 主要特性

• 藉助 Alpha Vantage API 高效獲取股票市場數據。
• 提供簡單的 MCP 接口，可訪問任意股票代碼的每日數據。

📦 安裝指南

安裝依賴

npm install

配置 API 密鑰

基於 .env.example 創建一個 .env 文件，並添加您的 Alpha Vantage API 密鑰：

ALPHA_VANTAGE_API_KEY=your_api_key_here

您可以從 Alpha Vantage 免費獲取一個 API 密鑰。

構建項目

npm run build

📚 詳細文檔

MCP 客戶端配置

若要將此工具與您的 MCP 客戶端配合使用，需更新 MCP 服務器配置。在客戶端配置中添加以下內容：

{
  "mcpServers": {
    "stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ]
    }
  }
}

請確保將 /ABSOLUTE/PATH/TO/PARENT/FOLDER 替換為您實際的父目錄路徑。

可用工具

get - stock - data

此工具可獲取特定股票代碼的每日股票市場數據。

• 參數：
  • symbol：股票代碼（例如 IBM、AAPL、MSFT、GOOG、AMZN）
• 在 MCP 客戶端中的示例使用：

@stock-market get-stock-data symbol=AAPL

• 示例響應：

股票：AAPL
最後更新時間：2025-03-12
時區：US/Eastern

每日價格：

日期：2025-03-12
開盤價：$178.35
最高價：$180.13
最低價：$177.53
收盤價：$179.63
成交量：58,492,206
---

日期：2025-03-11
開盤價：$177.99
最高價：$179.70
最低價：$176.86
收盤價：$178.95
成交量：62,630,570
---

開發相關

項目結構

• src/index.ts：主應用程序文件，包含 MCP 服務器和工具的實現。
• build/：編譯後的 JavaScript 輸出目錄。
• .env：存儲環境變量（API 密鑰）的文件。

命令

• npm run build：用於構建 TypeScript 代碼。

API 使用注意事項

本工具使用 Alpha Vantage API 獲取股票市場數據，免費層的 Alpha Vantage 有如下限制：

• 每日 25 次調用。
• 每分鐘 5 次調用。 若您需要更大的調用容量，可考慮升級到他們的付費計劃。

故障排除

若使用過程中遇到問題，可按以下步驟排查：

1. 確保您的 Alpha Vantage API 密鑰已正確設置在 .env 文件中。
2. 檢查是否使用了 Node.js 版本 18 或更高版本。
3. 驗證 MCP 客戶端配置中的路徑是否正確。
4. 重新啟動您的 MCP 客戶端。