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