Stock Market Server

🚀 股票市場 MCP 服務器

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

🚀 快速開始

本服務器是基於 TypeScript 的 MCP 服務器，藉助 Alpha Vantage API 提供即時股票市場信息和公司財務數據。以下是使用前的開發環境配置步驟。

安裝依賴

npm install

構建項目

npm run build

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

npm run watch

✨ 主要特性

工具

• get_ticker_price - 獲取股票即時價格

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

• get_market_report - 獲取美國市場報告

  • 提供市場整體狀況概覽

• get_financial_statement - 獲取公司財務報表

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

• get_company_overview - 獲取公司概覽信息

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

📦 安裝指南

要在 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 工具獲取股票即時價格的示例：

# 假設這裡是調用 get_ticker_price 的代碼示例
# 這裡需要根據實際情況補充調用代碼

高級用法

以下是獲取公司財務報表的示例，以獲取收入報表為例：

# 假設這裡是調用 get_financial_statement 獲取收入報表的代碼示例
# 這裡需要根據實際情況補充調用代碼

🔧 技術細節

本項目的技術棧主要包含以下幾個部分：

• TypeScript：作為主要的開發語言，為項目提供了類型檢查，增強了代碼的可維護性和健壯性。
• Node.js：作為運行時環境，使得項目可以在服務器端運行。
• Alpha Vantage API：用於獲取即時股票市場信息和公司財務數據。
• MCP SDK (@modelcontextprotocol/sdk)：為項目提供了與 MCP 相關的功能支持。

📄 許可證

[添加許可證信息]

⚠️ 重要提示

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