MINARA
参考环境变量

MCP

MCP（Model Context Protocol）集成

MINARA_MICROSOFT_PUBLIC_CLIENT_ID

Microsoft Entra 公共客户端应用 ID。

  • 作用: 启用 Outlook Mail、Outlook Calendar 和 OneDrive 的本地授权码 + PKCE 流程。
  • 消费方: src/connectors/microsoft-oauth.ts；这是公开标识，不会搭配客户端密钥。
  • 何时设置: 发布流程尚未注入已注册的 Minara 公共客户端 ID 时设置。
  • 未设置时: Microsoft 连接按钮禁用；Broker Connector 不受影响。
  • 格式: 为本地 loopback 回调注册的 Microsoft Entra 应用 UUID。
  • 设置归属: 非用户设置项

MCP_SERVERS

启动时额外拉起的 MCP 服务器的 JSON 数组。

  • 作用: 用用户提供的集合覆盖默认 MCP 服务器列表。适合在不改动 src/app.ts 的情况下接入自有的私有 MCP 服务器。
  • 消费方: src/app.ts。
  • 何时设置: 你有一个想暴露给 agent 的 MCP 服务器（stdio 或 streamable-HTTP）时。
  • 未设置时: 只使用下面内置的 MCP 接线。
  • 格式: JSON 数组，例如 [{"name":"defillama","command":"npx","args":["-y","@defillama/mcp"]}] 必须能解析为 Array<{name:string, command:string, args?:string[]}>。
  • 设置归属: 非用户设置项

DEFILLAMA_API_KEY

DefiLlama Pro REST API key。

  • 作用: 为经 src/defillama/client.ts 打 DefiLlama REST API 的 typed defillama_* category 工具鉴权（Pro 主机 path 前缀）。免费主机可不设；也可走 Minara forward。用 tool_search 的 namespace: "cap/defillama" 发现工具——没有 DefiLlama skill 包。
  • 消费方: src/defillama/client.ts 以及由 src/generated/defillama/catalog.ts 注册的 defillama_* passthrough 工具。
  • 何时设置: 你有 DefiLlama Pro 账户，想本地拿 Pro 限额 / 端点、不依赖 Minara forward 时。
  • 未设置时: 已登录时 Pro 主机调用经 Minara forward；否则走免费端点 / web 回退。
  • 格式: 来自 https://defillama.com 的原始 API key（Pro 注册）。
  • 设置归属: 设置 → API 密钥

DEFILLAMA_MCP_TOKEN

DefiLlama 托管 MCP token（legacy）。

  • 作用: 为 DefiLlama 托管 MCP 服务鉴权（付费档，速率限制高于免费端点）。已被 DEFILLAMA_API_KEY + 上面的 typed defillama_* 工具取代；仅为与 legacy MCP 接线向后兼容而保留。
  • 消费方: 接入 DefiLlama MCP 时的 src/app.ts。
  • 何时设置: 你已为 DefiLlama MCP 访问付费，想让 agent 用它而非公开 REST API 时。
  • 未设置时: DefiLlama 调用回退到 typed defillama_* 工具（当 DEFILLAMA_API_KEY 已设置时）或免费端点。
  • 格式: 来自 https://defillama.com 的不透明 token。
  • 设置归属: 非用户设置项

v1 Minara 后端 MCP sub-agent（tier-3 回退）

每个 URL 指向一个 streamable-HTTP MCP 端点。设置后，若没有 mcp.json 文件存在，匹配的 server 会注册为 tier-3 回退。优先用 minara mcp add 写入 mcp/servers.json， 供 tool_search 发现。 全部可选且各自独立门控——缺失的 env 不会 破坏任何其他东西。在 v1 中它们经 SSE 从 <name>-mcp-cloud.xxx/sse 提供；v2 使用 streamable-HTTP，因此 server 必须声明该 transport。

MCP_EVM_RPC_URL

原始 EVM JSON-RPC 子 agent 端点。

  • 作用: 把 evm_rpc MCP 服务器注册进 tier-3 回退清单（eth_call、simulate、原始日志，每次查询 15 步 / 240s 超时）。优先用 minara mcp add 写入 mcp/servers.json，供 tool_search 发现。
  • 消费方: 仅 src/app/mcp.ts 的 tier-3 回退。
  • 格式: 绝对 URL，无尾部斜杠。
  • 设置归属: 非用户设置项

MCP_ETHERSCAN_URL

Etherscan 风格浏览器子 agent 端点。

  • 作用: 把 etherscan MCP 服务器注册进 tier-3 回退清单（跨 60+ EVM 链的索引化 tx / log / 合约查询）。优先用 minara mcp add 写入 mcp/servers.json，供 tool_search 发现。
  • 消费方: 仅 src/app/mcp.ts 的 tier-3 回退。
  • 格式: 绝对 URL。
  • 设置归属: 非用户设置项

FMP_API_KEY

Financial Modeling Prep 公开股票数据。

  • 作用: 通过 tool_search 在 cap/fmp 命名空间发现的 typed FMP 工具（fmp_fundamentals / fmp_quotes / fmp_technicals / fmp_news / fmp_macro / fmp_analysts / fmp_calendar / fmp_etf / fmp_sectors / fmp_screener / fmp_sec）工具。调用方先用 tool_describe 检查选中的工具； 当前没有专门的 FMP Skill 包。 ⚠ 仅限公开股票 —— crypto 不在范围内。BTC/ETH/SOL 现货 查询交给 market.spot。加密货币储备类股票（MSTR、 SBET、COIN）作为股票属于范围内。 ⚠ FMP 不提供期权链或 Greeks。 ⚠ 少数端点受 tier 门控（Starter+）—— 例如批量 报价、完整 DCF 变体、日内 K 线、完整 13F 转储。 客户端把 tier 门控暴露为 FmpTierGateError（HTTP 402）， 以便 LLM 回退到单标的 / 基础变体调用。
  • 消费方: src/tools/fmp/*.ts 和 src/fmp/client.ts（每次调用都重新读取该变量，因此运维可在不重启的情况下轮换 key）。
  • 何时设置: 你有 FMP 账户，并希望通过 cap/fmp 获取公开股票数据时。
  • 未设置时: FMP 工具不会出现在能力发现结果中；调用方必须在没有 FMP 数据时安全降级。
  • 格式: 来自开发者 dashboard（https://site.financialmodelingprep.com/developer/docs）的原始 key 字符串（不含 URL 包裹）。定价：https://site.financialmodelingprep.com/developer/docs/pricing（Free 250/天，约 100 个样本标的；Starter 10K/天全标的覆盖，是真实场景使用的推荐最低档）。
  • Migration: 如果你此前设置了 MCP_FMP_URL=https://financial...?apikey=KEY，请提取 KEY 部分，改为设置 FMP_API_KEY=KEY。MCP_FMP_URL 和 MCP_FMP_INCLUDE 不再被读取。
  • 设置归属: 设置 → API 密钥

COIN_METRICS_API_KEY / FRED_API_KEY / EIA_API_KEY / NASDAQ_DATA_LINK_API_KEY / ALPHA_VANTAGE_API_KEY / TWELVE_DATA_API_KEY / MASSIVE_API_KEY

因子研究数据源凭证。

  • 作用: 在因子研究解析时点市场和经济数据时，启用 Coin Metrics、FRED / ALFRED、EIA、Nasdaq Data Link、Alpha Vantage、Twelve Data 和 Massive 的认证访问。
  • 消费方: src/strategy-studio/factor-research/default-data-sources.ts，通过已保存凭证解析器读取。
  • 何时设置: 仅设置研究工作区实际可用的数据源密钥。
  • 未设置时: 未设置的认证数据源会被跳过。请求条件允许时，Coin Metrics 社区数据仍可在没有密钥的情况下使用。
  • 格式: 对应数据源控制台签发的原始 API 密钥。
  • 设置归属: 设置 → API 密钥

SEC_USER_AGENT

原生访问 SEC EDGAR 数据时声明的身份。

  • 作用: 让 provider 中立的时点财务快照服务能调用 data.sec.gov 的 submissions + companyfacts 以及 www.sec.gov 的 ticker/CIK 映射。SEC 依其 Fair Access 政策要求自动化客户端标明产品及一个可联系的联系方式。
  • 消费方: src/capability/sec-edgar-client.ts 以及 Institution PIT 基本面预检。这不是 API key 或 secret。
  • 何时设置: 当 PIT_FINANCIAL_SNAPSHOT_MODE 为 shadow 或 enforce 时必填。
  • 未设置时: PIT 服务保持未接线，Institution 沿用其 legacy 基本面路径，即便 mode 偏好默认为 shadow。
  • 格式: "ProductName [email protected]"。不要使用虚假联系方式。
  • 设置归属: 非用户设置项

PIT_FINANCIAL_SNAPSHOT_MODE

Institution 时点财务的推出开关。

  • 作用: off 保持 legacy 路径；shadow 构建并持久化 SEC 支撑的快照，但不改变分析师输入；enforce 把快照提供给一个无工具的 Fundamentals 分析师，并启用分析缓存。
  • 消费方: 运行时 Preferences schema 中的 data.pitFinancialSnapshots.mode 以及 src/app/institution.ts。更改需重启 agent。
  • 默认值: shadow。可接受值：off | shadow | enforce。
  • 设置归属: 设置 → 偏好（schema 键）

MCP_SOLSCAN_URL

Solscan 兼容的 Solana 浏览器子 agent。

  • 作用: 把 solscan MCP 服务器注册进 tier-3 回退清单（索引化的 Solana 查询：SPL 转账、程序调用、账户历史）。优先用 minara mcp add 写入 mcp/servers.json，供 tool_search 发现。
  • 消费方: 仅 src/app/mcp.ts 的 tier-3 回退。
  • 格式: 绝对 URL。
  • 设置归属: 非用户设置项

MCP_GOPLUS_URL

GoPlus 多链 Web3 安全分析。

  • 作用: 把 goplus MCP 服务器注册进 tier-3 回退清单（代币蜜罐检查、授权风险、地址信誉）。优先用 minara mcp add 写入 mcp/servers.json，供 tool_search 发现。常见链的 GoPlus 安全覆盖已由内置的 security.token skill 提供，无需此 env var。
  • 消费方: 仅 src/app/mcp.ts 的 tier-3 回退。
  • 格式: 绝对 URL。
  • 设置归属: 非用户设置项

内置工具

内置工具（src/tools/*） 每个都是可选的——缺失 key → 该特性静默禁用。

外部 agent skill

外部 agent skill（src/skills/external/*） 每个 key 仅在对应 skill 被激活时才需要。 它们由所 vendored 的 skill 自身的 SKILL.md / 脚本消费， 通常经终端工具内联进 `curl` 调用。

本页目录

MINARA_MICROSOFT_PUBLIC_CLIENT_IDMCP_SERVERSDEFILLAMA_API_KEYDEFILLAMA_MCP_TOKENv1 Minara 后端 MCP sub-agent（tier-3 回退）MCP_EVM_RPC_URLMCP_ETHERSCAN_URLFMP_API_KEYCOIN_METRICS_API_KEY / FRED_API_KEY / EIA_API_KEY / NASDAQ_DATA_LINK_API_KEY / ALPHA_VANTAGE_API_KEY / TWELVE_DATA_API_KEY / MASSIVE_API_KEYSEC_USER_AGENTPIT_FINANCIAL_SNAPSHOT_MODEMCP_SOLSCAN_URLMCP_GOPLUS_URL