Alpha Vantage

🚀 股票市場 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，主要用於獲取股票市場數據。它藉助 Alpha Vantage API，能夠為用戶提供即時的股票市場信息以及公司財務數據。

✨ 主要特性

工具

• get_ticker_price - 獲取股票即時價格

  • 需提供股票代碼作為參數。
  • 會返回最新的股票價格和時間戳。

• get_market_report - 獲取美國市場報告

  • 可提供市場整體狀況概覽。

• get_financial_statement - 獲取公司財務報表

  • 支持三種報表類型：收入報表(income)、資產負債表(balance)、現金流量表(cashflow)。
  • 需提供股票代碼和報表類型。

• get_company_overview - 獲取公司概覽信息

  • 需提供股票代碼。
  • 會返回公司關鍵指標和基本信息。

📦 安裝指南

開發環境配置

安裝依賴

npm install

構建項目

npm run build

開發模式（自動重新構建）

npm run watch

在 Claude Desktop 中使用

要在 Claude Desktop 中使用此服務器，需要添加服務器配置：

MacOS

配置文件路徑：~/Library/Application Support/Claude/claude_desktop_config.json

Windows

配置文件路徑：%APPDATA%/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "stock-market-server": {
      "command": "/path/to/stock-market-server/build/index.js"
    }
  }
}

💻 使用示例

基礎用法

# 以下是調用 get_ticker_price 工具獲取股票即時價格的示例
# 假設股票代碼為 AAPL
# 代碼調用邏輯需根據實際項目封裝實現
# 這裡僅示意調用該工具的思路

高級用法

# 可以組合多個工具進行復雜的數據獲取，例如先獲取公司概覽信息，再獲取財務報表
# 同樣，代碼調用邏輯需根據實際項目封裝實現

🔧 技術細節

技術棧

• TypeScript
• Node.js
• Alpha Vantage API
• MCP SDK (@modelcontextprotocol/sdk)

📄 許可證

[添加許可證信息]

⚠️ 重要提示

• 使用前需要確保有有效的 Alpha Vantage API 密鑰。
• 所有 API 響應都以 JSON 格式返回。
• 請注意 Alpha Vantage API 的調用頻率限制。

💡 使用建議

由於 MCP 服務器通過標準輸入輸出(stdio)通信，調試可能比較困難。推薦使用 MCP Inspector 工具進行調試：

npm run inspector

運行後，Inspector 將提供一個瀏覽器訪問地址，可以通過瀏覽器使用調試工具。