Alpaca Trading MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Alpaca 交易 API 的接口，允许您管理您的股票和加密货币投资组合、下单交易以及访问市场数据。

功能

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

安装

1. 克隆此仓库
2. 安装依赖项：

pip install -e .

或者使用 uv:

uv pip install -e .

配置

1. 将 .env.example 文件复制到 .env：

cp .env.example .env

2. 将您的 Alpaca 模拟交易 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 App 配置。如果该文件不存在，请创建它。

• 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 For Server Developers: Quickstart

可用资源

服务器提供以下资源：

• account://info - 获取当前账户信息
• positions://all - 获取所有当前持仓
• positions://{symbol} - 获取特定代码的持仓详情
• orders://recent/{limit} - 获取指定数量的最新订单
• market://{symbol}/quote - 获取特定代码的当前市场报价
• market://{symbol}/bars/{timeframe} - 获取具有指定时间范围的代码的历史价格柱
• assets://list - 列出 Alpaca 上可交易的资产
• assets://{symbol} - 按代码获取详细的资产信息

可用工具

服务器提供以下工具：

• get_account_info_tool - 获取当前账户信息
• place_market_order - 下市价单买入或卖出股票
• place_limit_order - 以指定价格下限价单买入或卖出股票
• place_stop_order - 当股票达到指定价格时，下止损单买入或卖出股票
• place_stop_limit_order - 下结合止损和限价单功能的止损限价单
• cancel_order - 按 ID 取消未结订单
• close_position - 平仓特定代码的未结头寸
• get_portfolio_summary - 获取投资组合的全面摘要