Alpaca 交易 MCP 服务器

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

功能

• 账户管理：查看账户详情、余额及投资组合状态
• 交易：下单（市价单、限价单、止损单、止损限价单）
• 投资组合管理：查看持仓、计算表现并平仓
• 市场数据：获取实时报价及历史价格数据
• 资产信息：获取可交易资产的详细信息

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Alpaca 交易 MCP 服务器：

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

手动安装

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

pip install -e .

或者使用 uv：

uv pip install -e .

配置

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

cp .env.example .env

2. 在 .env 文件中添加您的 Alpaca 纸上交易 API 凭证：

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 服务器开发者快速入门

可用资源

服务器提供的资源包括：

• 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 - 获取投资组合的综合概览