00:00 / 00:00

Eidolon

MCP 服務

概述

LAPLACE Eidolon 在語音分身之外,額外對外開放一個唯讀的 Model Context Protocol(MCP)服務。它把驅動語音管線的同一套 RAG 索引——主播明前奶綠的人設事實與過往直播轉錄——公開給任意 MCP 用戶端(Claude Desktop、Cursor、自建 Agent 等),讓它們能夠檢索「她是誰」與「她在某場直播說過什麼」

服務以 Streamable HTTP 形式掛載於機器人主應用程式上,公開實例位於:

https://eidolon.vrp.moe/mcp

串接

多數支援 Streamable HTTP 的 MCP 用戶端只需設定 URL 即可:

{
  "mcpServers": {
    "laplace-eidolon": {
      "url": "https://eidolon.vrp.moe/mcp"
    }
  }
}

僅支援 stdio 傳輸的舊用戶端可經 mcp-remote 橋接:

{
  "mcpServers": {
    "laplace-eidolon": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://eidolon.vrp.moe/mcp"]
    }
  }
}

工具

服務公開兩個唯讀檢索工具,兩者均接受單一 query 字串參數,回傳命中清單:

search_persona_facts

檢索手工整理的主播人設事實——身分、設定、喜好與梗。適合穩定的「她是誰」類問題,而非回憶某場直播的具體片段

回傳結構:

{
  "count": 2,
  "results": [
    {
      "text": "人設事實原文",
      "date": "2026-05-09",
      "score": 0.82
    }
  ]
}
欄位含義
text人設事實原文
date事實對應的來源日期(可能為 null
score相關度評分

search_streams

檢索過往直播轉錄,回傳最相關的約 5 分鐘直播片段,附帶播出日期與話題。適合回憶「她在某場直播說過 / 做過什麼」

回傳結構:

{
  "count": 1,
  "results": [
    {
      "stream_date": "2026-04-20",
      "content": "經精煉的直播片段敘述",
      "topics": ["話題A", "話題B"],
      "score": 0.77
    }
  ]
}
欄位含義
stream_date直播播出日期(可能為 null
content精煉後的片段敘述(優先 details,回退 summary / 原始轉錄)
topics片段話題標籤陣列
score相關度評分

身分驗證與限流

服務預設匿名開放,無需任何憑證即可呼叫。兩類呼叫者享有相同的工具與相同的公開資料——權杖只提升吞吐配額,不解鎖任何私有內容(不涉及 Mem0,也不涉及任何按觀眾隔離的資料)

呼叫者驗證方式預設配額
匿名依用戶端 IP20 次/小時
已登入Authorization: Bearer <loginSyncToken>120 次/小時

所攜帶的 loginSyncToken 與 WebRTC 交握所用的是同一枚,由 LAPLACE Login Sync 驗證;辨識出的 Bilibili UID 用作限流鍵。無效、過期或缺少的權杖一律靜默視為匿名處理,不會回報錯誤。每次檢索都會消耗一次嵌入(及可選的 Cohere 重排),配額即用於約束這部分開銷

自行架設

公開實例之外,自行架設的 Eidolon 同樣預設掛載該服務。相關環境變數:

環境變數說明
EIDOLON_MCP_ANON_RATE_LIMIT_PER_HOUR匿名每小時配額,預設 20
EIDOLON_MCP_AUTH_RATE_LIMIT_PER_HOUR已登入每小時配額,預設 120
EIDOLON_MCP_RATE_LIMIT_WINDOW_SEC限流視窗秒數,預設 3600
EIDOLON_MCP_ALLOWED_HOSTS防 DNS-rebinding 的 Host 白名單(逗號分隔)

原始碼

最後更新於 2026年9月19日

Tech otakus destroy the world