AuraStream

aurastream-mcp

面向 AuraStream 的 MCP 服务。AuraStream 是统一的历史数据 API。它让 Claude Desktop、Claude Code、ChatGPT 和其他 MCP 客户端能够从加密货币交易所、Yahoo Finance、Oanda、Alpaca、Polygon 等来源获取 OHLCV K 线（部分来源还提供资金费率、交易、报价、订单簿和财报），以及宏观、持仓和交易流数据，例如 FRED、CFTC 交易者持仓报告、SEC 内部人交易、财报文件、计划中的内部人出售、8-K 事件、未交割证券、13D/13G 持股、13F 和共同基金／ETF 持仓及投票、美国经济数据发布日历、英国／欧盟／美国／香港金属贸易、TSA 旅行数据、历史天气和采暖度日、美国零售额和消费者支出（PCE）、USDA 作物预测（WASDE）、欧盟空头头寸、WARN 裁员通知、联邦合同支出，以及美联储声明、会议纪要和演讲：通过一个工具接入 AuraStream 的全部 45 个数据源。

询问“绘制 Binance 上 Q1 的 BTC 日收盘价”“比较 SPY 和 QQQ 今年以来的回撤”或“自 2020 年以来，对冲基金如何布局黄金期货？”，模型就会调用 AuraStream 获取数据。

工具

工具	功能
list_sources()	列出数据源、资产类别、代码格式、时间间隔、支持的数据类型和数据源特定参数，并说明是否需要以及是否已配置服务商凭据。不会调用 API。
get_timeseries(source, tickers, start, end, interval="1d", dtype="bars", price_type=None, instrument=None, continuous_contracts=None, ticktype=None, assetclass=None, category=None, feed=None, adjustment=None, indicator=None, dataset=None, report=None, options=None, as_of=None, concepts=None, period=None, mode=None, reporter=None, metric=None, level=None, db=None, filters=None, assetcol=None, index=None, variables=None, timezone=None, unit_group=None, vs_currency=None, sessiontemplate=None, closed_only=None, bartype=None, max_rows=100)	调用 POST /timeseries。每个代码返回一个 CSV 块（市场 K 线包含 timestamp,Open,High,Low,Close,Volume，其他情况包含数据源自身的字段），最多返回最近的 max_rows 行（上限为 1000），并注明总行数。
get_latest(source, tickers, interval="1d", bars=10)	返回每个代码最近的 N 根 K 线，无需指定日期。

每次调用 get_timeseries / get_latest 都会产生一次 AuraStream API 调用。

支持的数据源：

分组	数据源
加密货币	binance、bybit、kraken、deribit、kucoin、dydx、hyperliquid、lyra（Derive）；使用你自己的密钥：coinapi；订阅 Nemeton 后：nemeton（订单簿信号）
股票、外汇、期货、差价合约	yahoo；使用你自己的账户：oanda、alpaca、polygon、firstrate、tradestation、cityindex
宏观与能源	treasury、worldbank、sdmx（BIS、ECB、IMF、OECD 等）、econcalendar（美国数据发布时间）、fedtext（FOMC 声明、会议纪要、Fed 演讲）、wasde（USDA 农作物预测）；使用免费密钥：fred、eia、bea（PCE、收入、GDP）；使用你自己的密钥：tradingeconomics、nasdaq
基本面	edgar（内幕交易、已披露财务数据、收益申报文件、计划出售（144）、8-K 事件、交付失败、13D/13G 持仓、13F 持仓、基金和 ETF 持仓（N-PORT）及投票（N-PX））、usaspending（按公司划分的联邦合同）、warn（裁员通知）；使用你自己的密钥：finnhub
持仓与资金流	cftc（交易者持仓报告）、netshort（欧盟空头持仓）、hmrc、comext、hktrade；使用免费密钥：uscensus
加密货币基本面与新闻	defillama、gdelt；使用免费密钥：coingecko
天气与出行	openmeteo、degreedays（采暖和制冷度日）、tsa（每日航空旅客）；使用你自己的密钥：visualcrossing

日期格式为 YYYY-MM-DD。时间间隔遵循 API 规则：大写 M 表示分钟，小写 m 表示月（15M = 15 分钟，1m = 1 个月）。调用 API 前，服务会根据各数据源的文档值检查时间间隔、数据类型和参数。

安装

需要 Python 3.10+。

pip install aurastream-mcp

也可以使用 uv 直接运行，无需安装：uvx aurastream-mcp。

这会安装一个 aurastream-mcp 命令。运行 aurastream-mcp --help 查看帮助。

配置

所有密钥均来自环境变量。凭据绝不会作为工具参数，因此不会经过聊天或模型。

变量	用途
AURASTREAM_API_KEY	所有功能。可从控制面板免费获取密钥。
OANDA_ACCOUNT_ID、OANDA_TOKEN	oanda
OANDA_ENVIRONMENT	oanda，可选：practice（默认）或 live
ALPACA_API_KEY、ALPACA_SECRET_KEY	alpaca
POLYGON_API_KEY	polygon
FRED_API_KEY	fred
FINNHUB_API_KEY	finnhub
FIRSTRATE_USER_ID	firstrate：FirstRate Data 为 API 下载提供的用户 ID
EIA_API_KEY	eia（可从 eia.gov 免费获取）
CENSUS_API_KEY	uscensus：贸易和零售销售数据（可从 census.gov 免费获取）
BEA_API_KEY	bea（可从 apps.bea.gov 免费获取）
EDGAR_USER_AGENT	edgar 和 econcalendar（BLS）：你的姓名和联系邮箱，例如 Your Company [email protected]。SEC 要求提供此信息；无需注册。
NEMETON_API_KEY	nemeton：你的 Nemeton 订阅密钥
COINAPI_KEY	coinapi
COINGECKO_API_KEY 或 COINGECKO_DEMO_API_KEY	coingecko：Pro 密钥或免费 Demo 密钥（仅限最近 365 天的数据）
NASDAQ_DATA_LINK_API_KEY	nasdaq
TRADINGECONOMICS_API_KEY	tradingeconomics
TRADESTATION_CLIENT_ID、TRADESTATION_CLIENT_SECRET、TRADESTATION_REFRESH_TOKEN	tradestation
CITYINDEX_USERNAME、CITYINDEX_PASSWORD、CITYINDEX_APP_KEY	cityindex
VISUALCROSSING_API_KEY	visualcrossing
OPENMETEO_API_KEY	openmeteo，可选：设置后会发送

天气数据源使用 latitude,longitude 格式的地点代码，例如 48.85,2.35。

只设置你会用到的变量。list_sources 会告知模型已配置的数据源。

Claude Desktop

编辑 claude_desktop_config.json（Settings > Developer > Edit Config）：

{
  "mcpServers": {
    "aurastream": {
      "command": "aurastream-mcp",
      "env": {
        "AURASTREAM_API_KEY": "your-aurastream-key",
        "OANDA_ACCOUNT_ID": "101-004-12345678-001",
        "OANDA_TOKEN": "your-oanda-token"
      }
    }
  }
}

如果 Claude Desktop 找不到命令，请使用完整路径（例如 C:\\Users\\you\\venv\\Scripts\\aurastream-mcp.exe 或 /Users/you/venv/bin/aurastream-mcp）。之后重启 Claude Desktop。

Claude Code

claude mcp add aurastream -e AURASTREAM_API_KEY=your-aurastream-key -- aurastream-mcp

为需要凭据的数据源添加 -e FRED_API_KEY=... 等参数，并添加 --scope user，使其在每个项目中都可用。

托管服务（无需安装）

Unbiased Alpha 运行着一个共享实例，地址为 https://aurastream.unbiased-alpha.com/mcp。将支持远程 MCP 服务的任意客户端指向此地址，并发送你自己的 AuraStream 密钥：

• 在请求头中发送：x-api-key: <key> 或 Authorization: Bearer <key>；或者
• 在 URL 中发送，适用于无法设置请求头的客户端（ChatGPT）：https://aurastream.unbiased-alpha.com/mcp?api_key=<key>。任何看到此 URL 的人都能使用你的密钥，因此请像保护密钥本身一样保护它。

Claude Code：

claude mcp add --transport http aurastream https://aurastream.unbiased-alpha.com/mcp --header "x-api-key: your-key"

托管服务不会保存任何数据提供方密钥，因此需要你自己的数据提供方账户的数据源（FRED、Polygon、Nemeton 以及上表中的其他来源）只能通过本地安装使用。所有不需要数据提供方密钥的数据源均可使用。

ChatGPT（远程连接器）

最快的方式是使用上方托管的服务：将 https://aurastream.unbiased-alpha.com/mcp?api_key=<your key> 添加为连接器（Settings > Connectors，开发者模式）。如果要运行自己的服务：

ChatGPT 只能通过 HTTPS 与远程 MCP 服务通信，因此请在可访问的位置以 HTTP 模式运行服务，并将 URL 注册为连接器。

AURASTREAM_API_KEY=your-key aurastream-mcp --http --host 127.0.0.1 --port 8000
# endpoint: http://127.0.0.1:8000/mcp

将服务置于可提供公共 HTTPS URL 的组件之后（例如带 TLS 的反向代理，或 Cloudflare Tunnel、ngrok 之类的隧道），然后告诉服务要接受哪个公共主机名：

aurastream-mcp --http --port 8000 --allowed-host mcp.example.com

并在 ChatGPT 中添加 https://mcp.example.com/mcp。任何带有其他 Host 标头的请求都会被拒绝（DNS 重绑定保护）。

HTTP 模式下 API 密钥的工作方式。 如果客户端在 URL 中发送 x-api-key: <key>、Authorization: Bearer <key> 或 ?api_key=<key>，则会使用该密钥。否则，服务会回退到 AURASTREAM_API_KEY。这种回退方式正是 ChatGPT 目前能够正常工作的原因，但也意味着，任何知道该 URL 的人都能消耗你的额度并使用你的提供商凭据。请将 HTTP 模式视为仅供单用户使用的自托管服务：保密该 URL，或在服务前面添加你自己的身份验证。如果每位用户都使用自己的密钥，请使用 --require-client-key 禁用回退。提供商凭据始终来自服务的环境。

其他选项

aurastream-mcp [--http] [--host HOST] [--port PORT] [--path /mcp]
               [--allowed-host HOST ...] [--require-client-key] [--json-response]

AURASTREAM_API_URL 可覆盖端点（便于测试）。

示例提示词

• “AuraStream 有哪些外汇数据源？”
• “从 Binance 获取 2025 年的 BTCUSDT 和 ETHUSDT 日线数据，并计算它们的 30 日滚动相关性。”
• “显示 Oanda 的 EUR_USD 最近 20 根小时线。”
• “从 FRED 获取 2015 年以来的 UNRATE 和 DFF，并说明它们的走势有何关联。”
• “显示 Binance BTCUSDT 永续合约 2025 年 6 月的资金费率。”
• “自 2020 年以来，黄金期货中的管理基金持仓（CFTC）有何变化？”
• “2024 年哪些 AAPL 内部人士买入或卖出了股票？”
• “显示 2020 年以来英国每月向瑞士出口的黄金量。”
• “从 Yahoo 获取 SPY 和 QQQ 最近 6 个月的日线数据，并比较最大回撤。”

限制

• 提供的是历史数据，而非实时行情。最新一根数据可能仍在形成中。
• 每次数据调用都会计入你的 AuraStream 月度额度（免费方案：每月 500 次调用）。额度用完时，工具会提示你；额度会在每月 1 日 00:00 UTC 重置。免费方案还限制为每秒约 1 次请求。
• 为了控制大模型的上下文大小，每个代码的结果行数都有上限（默认 100 行，最多 1000 行）。如需获取较长的高精度历史数据，请直接使用 REST API 或 Python 客户端。
• API 会在 120 秒后超时；大型请求请拆分处理。
• 各数据源支持的时间间隔各不相同（请参阅文档）。

已知问题

• 非 K 线数据（资金费率、订单簿和持仓簿、交易、报价、财报、Finnhub 财务数据以及宏观、持仓和交易数据源）都会以通用表格形式呈现。
• 一些数据源的时间戳标记的是其描述的所属期间，而非实际发布时间（EIA、EDGAR 未交割数据、交易数据源）。list_sources 会标注延迟；回测前请平移数据。
• GDELT 搜索查询会受到 GDELT 本身的限流；请缩短查询范围。dataset="themes" 不受限流。

开发

python -m venv .venv
.venv/Scripts/activate        # or: source .venv/bin/activate
pip install -e ".[test]"
pytest

测试会模拟所有 HTTP 调用；无需 API 密钥。

许可证

MIT。详情请参阅 LICENSE。