概述
LAPLACE Eidolon 在語音分身之外,額外對外開放一個唯讀的 Model Context Protocol(MCP)服務。它把驅動語音管線的同一套 RAG 索引——主播明前奶綠的人設事實與過往直播轉錄——公開給任意 MCP 用戶端(Claude Desktop、Cursor、自建 Agent 等),讓它們能夠檢索「她是誰」與「她在某場直播說過什麼」
服務以 Streamable HTTP 形式掛載於機器人主應用程式上,公開實例位於:
https://eidolon.vrp.moe/mcp服務端點正規化為 /mcp/(帶尾斜線),/mcp 會以 307
重新導向至該位址。不跟隨重新導向的用戶端請直接使用帶尾斜線的網址
串接
多數支援 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 | 相關度評分 |
score 的含義隨檢索路徑而變:啟用 Cohere
重排時為相關度分數(越高越相關),未重排的純向量路徑則為距離(越低越相關)。當對應的
LanceDB 索引尚未建立時,工具回傳 count: 0 與一則說明性的
note,不會回報錯誤
身分驗證與限流
服務預設匿名開放,無需任何憑證即可呼叫。兩類呼叫者享有相同的工具與相同的公開資料——權杖只提升吞吐配額,不解鎖任何私有內容(不涉及 Mem0,也不涉及任何按觀眾隔離的資料)
| 呼叫者 | 驗證方式 | 預設配額 |
|---|---|---|
| 匿名 | 依用戶端 IP | 20 次/小時 |
| 已登入 | 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 白名單(逗號分隔) |
反向代理後須將公開網域寫入 EIDOLON_MCP_ALLOWED_HOSTS 以通過 SDK 的 Host
驗證,並像 /api/offer 一樣無緩衝地轉送 POST /mcp/。EIDOLON_MCP_ALLOWED_HOSTS 留空則關閉該保護,僅適合本機 localhost
偵錯
原始碼
最後更新於 2026年9月19日