Alpha Vantage Stock Analysis MCP Server

🚀 Alpha Vantage股票MCP服務器

這是一個藉助Alpha Vantage API提供股票市場數據的Model Context Protocol (MCP) 服務器。它能讓Claude和其他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桌面版一起使用

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

1. 打開Claude桌面版。
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替換為實際構建的index.js文件的絕對路徑。 4. 重啟Claude桌面版。

可用工具

基礎用法

get - stock - data

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

• symbol（必需）：股票代碼（例如IBM、AAPL）。
• interval（可選）：數據點之間的時間間隔（1min、5min、15min、30min、60min）。默認：5min。
• outputsize（可選）：返回的數據量（compact：最新100個數據點，full：最多20年的數據）。默認：compact。

get - daily - stock - data

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

• symbol（必需）：股票代碼（例如IBM、AAPL）。
• outputsize（可選）：返回的數據量（compact：最新100個數據點，full：最多20年的數據）。默認：compact。

高級用法

get - stock - alerts

分析股票數據並生成價格波動警報。 參數：

• symbol（必需）：股票代碼（例如IBM、AAPL）。
• interval（可選）：監控間隔。默認：5min。
• threshold（可選）：波動閾值百分比。默認：2%。

可用資源

股票數據資源

通過以下URI格式訪問股票數據：

stock://<symbol>[?<interval>&<outputsize>]

參數：

• symbol：股票代碼。
• interval（可選）：數據間隔，默認為5min。
• outputsize（可選）：輸出大小，compact或full。

示例

獲取AAPL的每日數據：

stock://AAPL?interval=1day&outputsize=full

📄 許可證

[此處插入許可證信息]