交易接口服务器

一个提供Alpaca交易API接口的服务器,用于管理股票和加密货币投资组合、执行交易和访问市场数据。

  • by laukikk
  • Python
  • 本地部署
  • 35 星标
  • 更新于
在 GitHub 查看 laukikk/alpaca-mcp

使用说明

羊驼交易MCP服务器

模型上下文协议(MCP)服务器,为Alpaca交易API提供接口,允许您管理股票和加密货币投资组合、进行交易和访问市场数据。

特性

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

安装

通过Smithery安装

通过以下方式为Claude Desktop自动安装羊驼交易MCP服务器 史密瑟里:

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

手动安装

  1. 克隆此存储库
  2. 安装依赖项:
pip install -e .

或使用紫外线:

uv pip install -e .

配置

  1. 复制 .env.example 文件到 .env:
cp .env.example .env
  1. 将您的Alpaca Paper Trading API凭证添加到 .env 文件:
ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"

您可以通过在以下网址创建帐户来获取这些凭据 羊驼.

用法

运行MCP服务器:

python src/server.py

服务器将启动并可供MCP客户端连接。

使用Claude进行桌面测试

配置:

在文本编辑器中打开Claude for Desktop App配置。如果文件不存在,则创建该文件。

  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • 雨衣: ~/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 -获取投资组合的全面摘要