🚀 Alpaca MCP 服务器

这是一个用于 Alpaca 的模型上下文协议 (MCP) 服务器，它能让像 Claude 这样的大型语言模型 (LLMs) 与 Alpaca 的交易 API 进行交互。借助该服务器，用户能够通过自然语言实现股票交易、查看持仓、获取市场数据以及管理账户等操作，极大地提升了交易的便捷性。

🚀 快速开始

Alpaca MCP 服务器允许大型语言模型与 Alpaca 的交易 API 交互，支持通过自然语言进行股票交易、查看持仓等操作。以下为您介绍使用步骤。

运行服务器

通过运行以下命令启动服务器：

python alpaca_mcp_server.py

配置 Claude for Desktop

1. 打开 Claude for Desktop。
2. 转到设置。
3. 点击“开发者”，然后点击“编辑配置”。
4. 将服务器配置添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "alpaca": {
      "command": "python",
      "args": [
        "/path/to/alpaca_mcp_server.py"
      ],
      "env": {
        "API_KEY_ID": "your_alpaca_api_key",
        "API_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

5. 保存并重新启动 Claude for Desktop。

示例查询

一旦服务器连接到 Claude，您可以提出以下问题：

• “当前我的账户余额和购买力是多少？”
• “显示我当前的持仓”
• “获取 AAPL 的最新行情”
• “显示 TSLA 过去 10 天的价格走势”
• “买入 5 股 MSFT 按市价成交”
• “卖出 10 股 TSLA，价格为 X”
• “取消所有未成交订单”

✨ 主要特性

• 📊 市场数据 - 获取实时股票报价和历史价格数据。
• 💵 账户信息 - 查看余额、购买力和账户状态。
• 📈 持仓管理 - 查看当前持仓及其表现。
• 🛒 订单下单 - 通过自然语言下单市价单和限价单。
• 📋 订单管理 - 列出、跟踪和取消订单。

📦 安装指南

先决条件

• Python 3.10+
• Alpaca API 密钥
• Claude for Desktop 或另一个 MCP 客户端

安装步骤

1. 克隆此仓库：

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

2. 安装所需的包：

pip install mcp alpaca-py python-dotenv

3. 创建一个 .env 文件，添加您的 Alpaca API 凭据：

API_KEY_ID=your_alpaca_api_key
API_SECRET_KEY=your_alpaca_secret_key

💻 使用示例

基础用法

服务器公开以下工具，您可以在代码中使用它们：

# 获取账户信息
get_account_info()
# 列出当前持仓
get_positions()
# 获取股票的最新行情
get_stock_quote(symbol)
# 获取股票的历史价格数据
get_stock_bars(symbol, days)
# 列出指定状态的订单
get_orders(status, limit)
# 下达市价单
place_market_order(symbol, side, quantity)
# 下达限价单
place_limit_order(symbol, side, quantity, limit_price)
# 取消所有未成交订单
cancel_all_orders()
# 平仓所有持仓
close_all_positions(cancel_orders)

📚 详细文档

注意事项

⚠️ 重要提示

此服务器需要有效的 Alpaca API 密钥才能正常运行。建议在生产环境中使用此工具时仔细审查代码并确保安全性。

安全提示

💡 使用建议

始终审查通过此服务器发送的指令，以防止未经授权的交易或操作。