AI导哈

加密货币市场数据服务

一个通过Alpaca API提供实时加密货币市场数据的模型上下文协议（MCP）服务器，支持历史K线数据、实时汇率和错误处理功能。

  • by berlinbra
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 berlinbra/alpaca-mcp

使用说明

羊驼MCP服务器

一种模型上下文协议（MCP）服务器，通过 API羊驼该服务器实现了用于检索加密货币数据的标准化接口。

特性

  • 每日、每周和每月的加密货币时间序列数据
  • 最新加密货币汇率
  • 历史柱状图/蜡烛图数据
  • 内置错误处理和速率限制管理

安装

使用克劳德桌面

通过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包安装程序，可以简化安装过程。将紫外线与羊驼毛蛋白一起使用：

  1. 第一， 安装UV 如果你还没有：
# Using pip
pip install uv

# Using brew on macOS
brew install uv
  1. 配置您的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"
      }
    }
  }
}
  1. 安装带有紫外线的包装：
# Clone the repository
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# Install dependencies using UV
uv pip install -e .
  1. 使用UV运行服务器：
uv run alpaca_mcp/server.py
  1. 出于调试目的，您可以使用MCP检查器：
npx @modelcontextprotocol/inspector uv --directory /path/to/alpaca-mcp run src/alpaca_mcp/server.py

标准开发设置

# Clone the repository
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package in development mode
pip install -e .

可用工具

目前，服务器实现了以下工具：

  • get-crypto-bars：获取加密货币的历史柱状图/蜡烛图数据

未来将添加更多工具。

获取加密酒吧

输入架构：

{
    "symbol": {
        "type": "string",
        "description": "Cryptocurrency symbol (e.g., BTC/USD, ETH/USD)"
    },
    "timeframe": {
        "type": "string",
        "description": "Timeframe for bars (e.g., 1Day, 1Hour, 1Min)",
        "default": "1Day"
    },
    "start": {
        "type": "string",
        "description": "Start date in YYYY-MM-DD format"
    },
    "limit": {
        "type": "integer",
        "description": "Maximum number of bars to return",
        "default": 10
    }
}

示例响应：

Cryptocurrency bars for BTC/USD (1Day):

Date: 2025-04-10
Open: $68750.12
High: $69200.45
Low: $67900.78
Close: $68900.32
Volume: 12345.67
---
Date: 2025-04-11
Open: $68900.32
High: $70100.55
Low: $68400.21
Close: $69800.44
Volume: 15678.90

错误处理

该服务器包括针对各种场景的全面错误处理：

  • 请求频率超限
  • API密钥无效
  • 网络连接问题
  • 超时处理
  • 响应格式错误

错误消息以清晰易读的格式返回。

先决条件

  • Python 3.12或更高版本
  • httpx
  • 主控程序
  • 羊驼皮
  • python dotenv（用于加载环境变量）

许可证

此MCP服务器根据MIT许可证获得许可。

相关 MCP