886a8e31d0
三件一條鏈(HANDOFF §2/§3b,kbdb-base Phase 9):
A. KBDB MCP 薄殼(9.1):mcp/src/tools/kbdb_data.ts 6 工具
template/record/query/search,調基本盤 API。鐵律:不給建表/SQL,只 template+slot。
B. MCP self-hosted 認證 401(mcp-account-source §5.5):
- partner-auth.ts:MULTI_TENANT=false 時 Bearer 明碼直接當 org_namespace,
繞 KBDB partner 驗證(對齊 cypher 的 opaque-key 模型)。官方 SaaS 行為不變、共用同碼。
- mcp-setup.ts:把 namespace/api_key 寫進 .mcp.json headers.Authorization。
- 新增 self-hosted vs SaaS 分支單測(9 tests 綠)。
C. cypher KBDB proxy(9.5)+ CLI 薄殼(9.2):
- routes/kbdb-proxy.ts 純轉發 /kbdb/* → KBDB 基本盤(KBDB_BASE_URL HTTP fetch,
不新增 service binding)。讓 CLI(只認證到 cypher)能達獨立 KBDB worker。
- 租戶隔離:X-Arcrun-API-Key 自動當 owner_id 注入 records/entries(強制覆寫防跨租戶);
templates 全域共享(虛擬表定義是 schema 非資料)。
- cli/src/commands/kbdb.ts:acr kbdb template/record/query/search,與 MCP kbdb_* 同能力。
- kbdb base:entries 加 page_name 過濾(9.3)。
cypher + cli + mcp tsc exit 0。未驗收:端到端需 deploy + KBDB_BASE_URL 可達後實測。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
36 lines
2.1 KiB
TOML
36 lines
2.1 KiB
TOML
name = "arcrun-mcp" # 2026-06-06 搬進主庫 arcrun/mcp/,對齊 arcrun-* 命名(SDD mcp-account-source.md §5)
|
||
main = "src/index.ts"
|
||
compatibility_date = "2024-11-27"
|
||
compatibility_flags = [ "nodejs_compat" ]
|
||
workers_dev = true # 對齊 arcrun 部署慣例(rule 05):deploy 掃描自動啟用 workers.dev URL
|
||
|
||
# ── 租戶模式(self-hosted fork 必看)─────────────────────────────────────────────
|
||
# 官方 SaaS:不設 MULTI_TENANT(預設多租戶)→ MCP 走 partner-key 驗證(pk_live)。
|
||
# self-hosted 單租戶:fork 後設 MULTI_TENANT = "false" → MCP 接受 Bearer = namespace 明碼,
|
||
# 不打 KBDB partner 驗證,直接當 org_namespace(與 cypher-executor 的 MULTI_TENANT=false 對齊)。
|
||
# self-hosted 用戶用 namespace 明碼即可連 MCP(不需平台 partner key)。
|
||
# SDD: sdk-and-website/mcp-account-source.md(self-hosted 認證);HANDOFF §3b。
|
||
# [vars]
|
||
# MULTI_TENANT = "false"
|
||
|
||
# Service Bindings
|
||
# 2026-05-07:COMPONENT_REGISTRY 從 inkstone-component-registry 改為 arcrun-registry
|
||
# 原因:舊的 inkstone-component-registry 期望不同 query 參數名,MCP search 失敗。
|
||
# 新的 arcrun-registry(registry.arcrun.dev)才是現役。
|
||
services = [
|
||
{ binding = "COMPONENT_REGISTRY", service = "arcrun-registry" },
|
||
{ binding = "CYPHER_EXECUTOR", service = "arcrun-cypher-executor" },
|
||
{ binding = "KBDB", service = "arcrun-kbdb" }
|
||
]
|
||
|
||
# Route — MCP 搬進 arcrun 主庫後改用 arcrun.dev zone(與其他 worker 一致)。
|
||
# 舊的 studio.finally.click 是 inkstone 平台 zone,arcrun 帳號沒有該 zone → 部署 route 失敗。
|
||
# 對外正式 MCP URL = mcp.arcrun.dev;對內 / fork 仍可走 workers_dev=true 的 arcrun-mcp.<sub>.workers.dev。
|
||
[[routes]]
|
||
pattern = "mcp.arcrun.dev/*"
|
||
zone_name = "arcrun.dev"
|
||
|
||
# [alias] 移除:之前是 Zod 4 的 compat shim,但 MCP SDK 1.x 用的是 Zod 3 介面,
|
||
# shim 讓 SDK 拿到 Zod 4 內部結構,introspect schema 時報 _zod undefined。
|
||
# 降到 Zod 3.x 後不需要 shim(package.json)。
|