Alpaca MCP 服务器

暴露 Alpaca 市场数据及经纪商 API 作为 MCP 工具。

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Alpaca 市场数据服务器到 Claude Desktop：

npx -y @smithery/cli install @cesarvarela/alpaca-mcp --client claude

手动安装

npm install alpaca-mcp

本地开发

git clone <repo-url>
cd alpaca-mcp
npm install

环境变量

在项目根目录创建一个 .env 文件，内容如下：

ALPACA_ENDPOINT=https://data.alpaca.markets
ALPACA_BROKER_ENDPOINT=https://broker-api.alpaca.markets
ALPACA_API_KEY=YOUR_ALPACA_API_KEY
ALPACA_SECRET_KEY=YOUR_ALPACA_SECRET_KEY

命令

• 启动 (开发模式): npm start (运行 npx tsx index.ts)
• 构建: npm run build (编译到 dist/)
• 运行已编译的代码: node dist/index.js

使用方法

运行后，MCP 服务器监听标准输入/输出。可以使用任何 MCP 客户端或 CLI：

npm link      # 可选
alpaca-mcp    # 全局启动服务器

可用工具

• 获取资产 { assetClass?: "us_equity" | "crypto" }
• 获取股票条形图 { symbols: string[]; start: string; end: string; timeframe: string }
• 获取市场日 { start: string; end: string }
• 获取新闻 { start: string; end: string; symbols: string[] }

每个工具返回 JSON 格式的数据在 content[0].text 中，或者返回错误信息。

MCP 客户端配置

要在 mcp.config.json 中集成，添加以下内容到 mcpServers 键下：

{
  "mcpServers": {
    "alpaca-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alpaca-mcp"
      ],
      "env": {
        "ALPACA_ENDPOINT": "https://data.alpaca.markets",
        "ALPACA_BROKER_ENDPOINT": "https://broker-api.alpaca.markets",
        "ALPACA_API_KEY": "<YOUR_API_KEY>",
        "ALPACA_SECRET_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

发布

npm publish

许可证

ISC