Stock Analysis MCP

🚀 Alpha Vantage 股票 MCP 服務器

這是一個基於模型上下文協議 (MCP) 構建的服務器，它藉助 Alpha Vantage API 提供股票市場數據。Claude 等 MCP 客戶端可通過該服務器訪問即時和歷史股票數據，為股票分析等應用場景提供有力支持。

✨ 主要特性

• 可獲取帶有可自定義間隔的盤中股票數據，滿足不同時間粒度的分析需求。
• 支持獲取每日股票數據，方便進行長期趨勢分析。
• 能夠根據價格波動生成股票警報，及時提醒用戶關注股價變化。
• 可作為資源直接訪問股票數據，便於與其他系統集成。

📦 安裝指南

先決條件

• Node.js 16 或更高版本。
• Alpha Vantage API 密鑰（免費獲取地址：Alpha Vantage）

安裝步驟

1. 克隆此倉庫。
2. 安裝依賴項：

   npm install
   

3. 在項目根目錄中創建一個 .env 文件，並添加您的 Alpha Vantage API 密鑰：

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

🚀 快速開始

構建和運行

• 構建 TypeScript 代碼：

npm run build

• 運行服務器：

npm start

• 開發時使用自動重載：

npm run dev

• 測試 API 客戶端：

npm test

與 Claude Desktop 集成

要將此 MCP 服務器與 Claude Desktop 一起使用，可按以下步驟操作：

1. 打開 Claude Desktop。
2. 轉到設置 > 開發者 > 編輯配置。
3. 將以下內容添加到 claude_desktop_config.json 中：

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
      } 
    }
  }
}

請將 /absolute/path/to/dist/index.js 替換為您構建目錄中的實際路徑。 4. 重啟 Claude Desktop。

📚 詳細文檔

可用工具

get-stock-data

獲取特定股票的盤中數據。

get-daily-stock-data

獲取特定股票的每日數據。

get-stock-alerts

分析股票數據以生成價格波動相關的警報。

可用資源

stock-data

直接作為資源訪問股票數據。

示例用法：

• “Can you analyze this stock data: stock://AAPL/daily”
• “What do you think about this data: stock://MSFT/5min”

📄 許可證

本項目採用 ISC 許可證。