羊驼-MCP-服务器

Name: 羊驼-MCP-服务器
Author: MardiantoS

作者：MardiantoS2 星标更新：2025-04-24

安装使用来源：spider==github.com

项目介绍

Alpaca Trading MCP Server

<strong>用于Alpaca交易的模型上下文协议（MCP）服务器的Python实现</strong>

</div>

这是一个针对Alpaca交易的模型上下文协议（MCP）服务器实现，它使大型语言模型（如Anthropic Claude）能够与Alpaca的交易API进行交互。本README中提供的指令和命令主要适用于MacOS/Linux用户。

<p align="center"> <img src="images/alpaca-mcp-server-demo.gif" alt="使用Claude桌面应用的Alpaca MCP服务器演示"> <figcaption align="center"><em>左侧显示的是Claude桌面应用，右侧是Alpaca网络控制台，用于验证操作。</em></figcaption> </p>

简介

模型上下文协议（MCP）

模型上下文协议（MCP）是由Anthropic开发的一个开放协议，标准化了应用程序如何向大型语言模型提供上下文。可以将MCP想象成AI应用程序的USB-C端口。就像USB-C提供了一种标准方式来连接设备到各种外围设备和配件一样，MCP提供了一种标准方式来连接AI模型到不同的数据源和工具。

Alpaca

Alpaca是一个现代经纪平台，通过开发者友好的API提供对金融市场的访问。通过使用Alpaca API，企业可以构建投资应用程序和服务功能。此外，程序化交易者可以开发算法以自动化交易策略。

免责声明

重要提示：本软件按“原样”提供，不附带任何形式的保证。使用此代码时，您承认交易涉及重大风险，作者不对因使用本软件而产生的任何财务损失负责。用户承担使用此实现所做交易决策的所有责任。在考虑使用真实资金进行实时交易之前，请始终使用模拟交易进行测试。

参考资料

功能

账户管理：查看账户信息和投资组合摘要
市场数据：访问实时报价和历史价格条形图
交易操作：下单市价单和限价单
持仓跟踪：监控当前持仓和最近订单

预备条件

uv（Python包和项目管理器）安装命令：
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
[可选] Claude桌面应用（用于测试的Claude客户端应用）

安装

克隆此仓库

git clone https://github.com/MardiantoS/alpaca-mcp-server.git
cd alpaca-mcp-server

[可选但推荐] 创建并激活虚拟环境：
```
uv venv
source .venv/bin/activate
```
安装依赖项。uv会读取uv.lock文件，并安装所有指定版本的依赖项
```
uv sync
```
在项目根目录创建一个.env文件，并添加您的Alpaca凭证：
```
ALPACA_API_KEY=your_api_key
ALPACA_API_SECRET=your_api_secret
ALPACA_PAPER=TRUE
```
注意：Alpaca API密钥可以在Alpaca开发者网络控制台获取。参考Alpaca文档。

使用方法（使用Claude桌面应用测试您的Alpaca MCP服务器）

确保已安装Claude桌面应用。

在您的Claude桌面应用中，进入设置（这是菜单栏中的设置，而不是应用内的设置），然后转到开发者标签页，点击“编辑配置”。这将定位到claude_desktop_config.json文件。

或者，您可以在~/Library/Application Support/Claude/claude_desktop_config.json找到它（或参阅MCP文档网站如果文件位置发生变化）

在mcpServers键中添加服务器。

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

注意：请确保替换uv和alpaca-mcp-server目录的实际路径。提示：运行which uv以显示您的绝对uv路径。

如果已经启动，重新启动您的Claude桌面应用。点击锤子图标以验证可用的MCP工具。您可以尝试以下查询：
- “我的当前Alpaca投资组合余额是多少？”
- “下单购买10股摩根大通股票，限价238美元。”
- “以市场价格购买1股谷歌股票。”
- “下单卖出1股苹果股票，限价210美元。”
- “取消我卖出苹果股票的限价单。” 注意：如果提示，请允许工具运行。

可用资源

account://info - 获取账户信息
positions://all - 获取所有当前持仓
market://quote/{symbol} - 获取某个符号的最新报价
market://bars/{symbol} - 获取某个符号的历史条形图（过去7天）
orders://recent - 获取最近的订单（过去7天）

注意：实时市场数据功能如报价和历史条形图可能仅在拥有实时交易账户的情况下完全可用，具体取决于您的Alpaca订阅级别。

可用工具

place_market_order(symbol, side, qty) - 下市价单
place_limit_order(symbol, side, qty, limit_price) - 下限价单
cancel_order(order_id) - 取消现有订单
get_portfolio_summary() - 获取当前投资组合摘要

安全特性

默认使用模拟交易（ALPACA_PAPER=TRUE）
正确的错误处理和日志记录
使用contextlib优雅地启动和关闭

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

引用

如果您在研究或项目中使用了本作品，请使用以下引用：

Mardianto Hadiputro. (2025). Alpaca Trading MCP Server. GitHub. https://github.com/MardiantoS/alpaca-mcp-server