Alpaca Trading MCP Server

Name: Alpaca Trading MCP Server
Author: laukikk

本地服务

github.com/laukikk金融数据3567 周前更新

代码仓库

关于 Alpaca Trading MCP Server

Alpaca Trading MCP Server 是连接 Alpaca 交易 API 的 MCP 服务，用于管理股票与加密货币投资组合、下单并获取市场数据。README 中的配置示例使用模拟交易（Paper Trading）凭据，适合希望通过 AI 客户端访问交易功能的用户。

主要功能

01查看账户信息、余额与投资组合状态
02下达市场单、限价单、止损单和止损限价单
03查看持仓、计算表现并平仓
04获取实时报价与历史价格数据
05查询可交易资产信息

适用场景

01通过 AI 客户端查询 Alpaca 账户余额与持仓
02在模拟交易账户中测试下单逻辑
03获取股票报价与历史 K 线数据

MCP 相关

该项目是 MCP 服务，通过账户、订单、持仓、行情和资产相关的资源与工具向 MCP 客户端提供交易接口。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "alpaca": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Alpaca Trading MCP Server

一个 Model Context Protocol（MCP）服务，为 Alpaca 交易 API 提供接口，让你能够管理股票和加密货币投资组合、下单交易并访问市场数据。

功能

账户管理：查看账户详情、余额和投资组合状态
交易：下达市价单、限价单、止损单和止损限价单
投资组合管理：查看持仓、计算绩效并平仓
市场数据：访问实时报价和历史价格数据
资产信息：获取可交易资产的详情

安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 Alpaca Trading MCP Server：

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

手动安装

克隆此仓库
安装依赖项：

pip install -e .

或使用 uv：

uv pip install -e .

配置

将 .env.example 文件复制为 .env：

cp .env.example .env

将你的 Alpaca Paper Trading API 凭据添加到 .env 文件中：

ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"

你可以在 Alpaca 创建账户来获取这些凭据。

使用

运行 MCP 服务：

python src/server.py

服务启动后，MCP 客户端即可连接。

使用 Claude for Desktop 进行测试

配置：

在文本编辑器中打开 Claude for Desktop 应用配置文件。如果文件不存在，请创建该文件。

Windows：%APPDATA%\Claude\claude_desktop_config.json
Mac：~/Library/Application\ Support/Claude/claude_desktop_config.json

添加 Alpaca MCP 服务配置：

{
    "mcpServers": {
        "alpaca": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
                "run",
                "src/server.py"
            ]
        }
    }
}

MCP 服务开发者快速入门