Alpaca交易API服务

一个提供Alpaca Trading v2和股票期权市场数据的MCP服务器,适用于需要非流式金融数据访问和交易执行的场景。

  • by ideadesignmedia
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ideadesignmedia/alpaca-mcp

使用说明

@ideadedesignmedia/羊驼mcp

MCP服务器,公开Alpaca Trading v2和股票和期权的市场数据。它假设您拥有市场数据权限。不使用流媒体。一旦完成,将获取并返回响应。

身份验证源:CLI标志,然后是env。

  • 旗帜: --key-id, --secret-key, --paper
  • 环境: ALPACA_KEY_ID, ALPACA_SECRET_KEY, ALPACA_PAPER=true|false

交易基础URL由纸质标志选择。市场数据库始终 https://data.alpaca.markets.

安装

npm i -g @ideadesignmedia/alpaca-mcp

用法

alpaca-mcp --paper   --key-id AK...   --secret-key SK...

您还可以按需运行它,而无需全局安装:

npx @ideadesignmedia/alpaca-mcp --paper --key-id AK... --secret-key SK...

或者通过env:

ALPACA_PAPER=true ALPACA_KEY_ID=AK... ALPACA_SECRET_KEY=SK... alpaca-mcp

这将使用以下命令启动MCP服务器 @ideadesignmedia/open-ai.js.运输方式为stdio;配置您的MCP客户端以启动此二进制文件并通过标准输入/输出进行通信。

MCP客户端配置

将服务器条目添加到MCP客户端配置中。下面的示例使用通用JSON布局;调整以匹配客户端的配置格式。

{
  "servers": [
    {
      "id": "alpaca",
      "name": "Alpaca Trading",
      "command": "npx",
      "args": [
        "@ideadesignmedia/alpaca-mcp",
        "--paper",
        "--key-id",
        "AK...",
        "--secret-key",
        "SK..."
      ],
      "env": {
        "ALPACA_PAPER": "true"
      }
    }
  ]
}

如果您的客户端支持环境变量secrets,请首选设置 ALPACA_KEY_ID 和 ALPACA_SECRET_KEY 通过其秘密管理器,而不是将它们作为命令参数传递。

工具

交易微型工具:

  • alpaca.get_account, alpaca.get_account_config, alpaca.update_account_config, alpaca.list_account_activities
  • alpaca.list_assets, alpaca.get_asset
  • alpaca.list_positions, alpaca.get_position, alpaca.close_position, alpaca.close_all_positions
  • alpaca.create_order, alpaca.get_order, alpaca.list_orders, alpaca.cancel_order, alpaca.cancel_all_orders, alpaca.replace_order
  • alpaca.list_watchlists, alpaca.get_watchlist, alpaca.get_watchlist_by_name, alpaca.create_watchlist, alpaca.update_watchlist, alpaca.delete_watchlist, alpaca.add_to_watchlist, alpaca.remove_from_watchlist
  • alpaca.get_clock, alpaca.get_calendar
  • alpaca.get_portfolio_history
  • alpaca.list_announcements

市场数据微工具:

  • 股票最新: alpaca.data.stocks.latest_bar, alpaca.data.stocks.latest_quote, alpaca.data.stocks.latest_trade, alpaca.data.stocks.snapshot, alpaca.data.stocks.snapshots
  • 股票历史: alpaca.data.stocks.bars, alpaca.data.stocks.quotes, alpaca.data.stocks.trades
  • 最新选项: alpaca.data.options.snapshots, alpaca.data.options.latest_trades, alpaca.data.options.latest_quotes, alpaca.data.options.chain
  • 历史选项: alpaca.data.options.bars, alpaca.data.options.trades, alpaca.data.options.quotes
  • 新闻: alpaca.data.news
  • 公司行为: alpaca.data.corporate_actions

宏工具:

  • alpaca.get_stock_info 资产元、快照、最新数据、简史、新闻、公司行为摘要
  • alpaca.account_overview 账户、未结订单、头寸、时钟
  • alpaca.lookup_asset 便利资产搜索

所有工具都是非流媒体的。大型结果集被分页。您可以在支持它的历史端点上传递page_token。

安全

没有记录钥匙。缺少凭据会产生明显的错误。不使用持久性。

许可证

麻省理工学院