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