MCP 100 Stock Market Server

🚀 股票市場 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
# 這裡只是示意調用，實際可能需要封裝調用邏輯
# 調用 get_ticker_price 函數獲取 AAPL 的即時價格

高級用法

以下是獲取公司財務報表的示例，以獲取蘋果公司（AAPL）的收入報表為例：

# 調用 get_financial_statement 函數獲取 AAPL 的收入報表

🔧 技術細節

技術棧

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

調試

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

npm run inspector

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

📄 許可證

[添加許可證信息]

⚠️ 重要提示

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