使用说明
羊驼交易MCP服务器
模型上下文协议(MCP)服务器,为Alpaca交易API提供接口,允许您管理股票和加密货币投资组合、进行交易和访问市场数据。
特性
- 账户管理:查看账户详细信息、余额和投资组合状态
- 交易:下达市价单、限价单、止损单和止损限价单
- 投资组合管理:查看头寸、计算绩效和关闭头寸
- 市场数据:访问实时报价和历史价格数据
- 资产信息:获取可交易资产的详细信息
安装
通过Smithery安装
通过以下方式为Claude Desktop自动安装羊驼交易MCP服务器 史密瑟里:
npx -y @smithery/cli install @laukikk/alpaca-mcp --client claude
手动安装
- 克隆此存储库
- 安装依赖项:
pip install -e .
或使用紫外线:
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"
您可以通过在以下网址创建帐户来获取这些凭据 羊驼.
用法
运行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"
]
}
}
}
可用资源
服务器提供以下资源:
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-获取投资组合的全面摘要