Alpaca MCP

🚀 Alpaca MCP 服務器

Alpaca MCP 服務器是一個提供即時訪問加密貨幣市場數據的模型上下文協議 (MCP) 服務器，它藉助 Alpaca API 來實現。該服務器實現了一個標準接口，可用於獲取加密貨幣數據，為用戶提供便捷、高效的加密貨幣市場數據訪問體驗。

🚀 快速開始

Alpaca MCP 服務器可幫助你即時獲取加密貨幣市場數據。下面將為你介紹其安裝和使用的相關信息。

✨ 主要特性

• 多週期數據支持：提供每日、每週和每月的加密貨幣時間序列數據。
• 即時匯率獲取：可獲取最新的加密交易所匯率。
• 歷史數據呈現：提供歷史條形圖/蠟燭圖數據。
• 完善的管理機制：內置錯誤處理和速率限制管理。

📦 安裝指南

使用 Claude Desktop

通過 Docker 安裝

• 克隆倉庫並構建本地鏡像以供您的 Claude 桌面客戶端使用：

cd alpaca-mcp
docker build -t mcp/alpaca .

• 修改您的 claude_desktop_config.json 文件，使其與以下配置匹配，將 REPLACE_API_KEY 和 REPLACE_API_SECRET 替換為您實際的密鑰：

claude_desktop_config.json 路徑

• 在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPACA_API_KEY",
        "-e",
        "ALPACA_API_SECRET",
        "mcp/alpaca"
      ],
      "env": {
        "ALPACA_API_KEY": "REPLACE_API_KEY",
        "ALPACA_API_SECRET": "REPLACE_API_SECRET"
      }
    }
  }
}

通過 UV（快速 Python 包安裝器）安裝

UV 是一個現代的 Python 包安裝器，可以簡化安裝過程。要使用 UV 安裝 alpaca-mcp：

1. 首先 安裝 UV 如果您還沒有它：

# 使用 pip
pip install uv

# 在 macOS 上使用 brew
brew install uv

2. 配置您的 Claude Desktop 配置文件以使用 UV：

{
  "mcpServers": {
    "alpaca": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/alpaca-mcp",
        "run",
        "alpaca-mcp"
      ],
      "env": {
        "ALPACA_API_KEY": "REPLACE_API_KEY",
        "ALPACA_API_SECRET": "REPLACE_API_SECRET"
      }
    }
  }
}

3. 使用 UV 安裝包：

# 克隆倉庫
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# 使用 UV 安裝依賴項
uv pip install -e .

4. 使用 UV 運行服務器：

uv run alpaca_mcp/server.py

5. 為了調試目的，您可以使用 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory /path/to/alpaca-mcp run src/alpaca-mcp/server.py

標準開發設置

# 克隆倉庫
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# 創建並激活虛擬環境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv/Scripts/activate

📚 詳細文檔

錯誤處理

服務器包含全面的錯誤處理，針對各種情況：

• 速率限制超過
• 無效 API 密鑰
• 網絡連接問題
• 超時處理
• 模糊響應

錯誤消息以清晰的人類可讀格式返回。

先決條件

📄 許可證

此 MCP 服務器根據 MIT License 許可。