Alpaca MCP Server

🚀 交易Alpaca的MCP服务器

本项目是用于Alpaca交易的模型上下文协议（MCP）服务器的Python实现，能让大型语言模型（LLMs）如Anthropic Claude与Alpaca的交易API进行交互，为金融交易带来更智能的体验。

🚀 快速开始

本项目是为Alpaca交易实现的模型上下文协议（MCP）服务器，可使大型语言模型（LLMs）如Anthropic Claude与Alpaca的交易API交互。以下说明和命令主要针对MacOS/Linux用户。

✨ 主要特性

模型上下文协议（MCP）

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

Alpaca

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

⚠️ 免责声明

⚠️ 重要提示

此软件按原样提供，不附带任何形式的担保。使用此代码，您承认交易涉及重大风险，并且作者不对因使用此软件而导致的任何财务损失负责。用户自行承担使用本实现所做交易决策的责任。建议在进行实盘交易之前，在测试环境中使用纸币交易。

📚 详细文档

参考资料

• MCP Python SDK
• Alpaca Python SDK

可用资源

• account://info - 获取账户信息
• positions://all - 获取所有当前持仓
• market://quote/{symbol} - 获取指定股票的最新行情
• market://bars/{symbol} - 获取指定股票的历史数据（过去7天）
• orders://recent - 获取最近订单（过去7天）

注意：实时市场数据功能如行情和历史数据可能仅在使用实盘交易账户时 fully accessible，具体取决于您的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）
• 合适的错误处理和日志记录
• 使用上下文库实现优雅启动和关闭

📄 许可证

此项目在MIT License下许可 - 有关详细信息，请参阅LICENSE文件。

📚 引用

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

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