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 许可。