arcrun-mcp 缺 graph 查詢 tool——graph_neighbors 已 workflow 化但未曝成 MCP 工具 #68
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
現象（claude.ai 2026-07-19 實測）：MCP tools 只有 kbdb_query/kbdb_search/kbdb_get_record 等，AI 想做關係遍歷找不到工具；graph 查詢其實已有（graph_neighbors/graph_traverse workflow＋
/q/:ns/:name同步端點，#28 地基）。建議：mcp 加
kbdb_graph_neighbors（薄殼調/q端點，subject/depth 參數），對齊 D17「KBDB MCP＝RAG 套餐：關鍵字內建/語義開 vectorize/圖裝 graph」的三模式完整性——現在 MCP 面只有兩模式。出處：D17；rag-wave1 tasks T5-graph；雲端總管代開。
PR 已開：#71（#71）
kbdb_graph_neighbors（mcp/src/tools/kbdb_graph.ts）：薄殼調GET /q/:ns/graph_neighbors同步查詢端點（#28 地基），subject/depth 參數＋workflow input 形狀（kbdb_base/template/directed），namespace 自動用 MCP token 綁的 orgNamespace。workflow_not_installed＋安裝指引，不 crash。kbdb_graph_traverse未加：repo 內無 graph_traverse workflow 定義可對齊 input 形狀，不猜（等 workflow 進 registry 再一行補上）。PR#71 總管逐項審通過已 merge（薄殼零新 binding／404 誠實安裝指引／59/59 綠）。#68 保持 open 直到 gated redeploy arcrun-mcp（leo 閘）＋live tools/list 驗到 kbdb_graph_neighbors 才關。
部署驗證（leo 本機）：tools/list 41 工具含 kbdb_graph_neighbors ✅。剩最後一步才關：真呼叫一次（claude.ai 重連 arcrun-leo21c connector 後叫它 kbdb_graph_neighbors，subject 給 RAG 或 00-INDEX、kbdb_base 給 https://arcrun-kbdb.leo21c.workers.dev）驗 MCP→/q→workflow 全鏈；雲端無 MCP static token 代打不了。
e2e 實測（雲端總管經 claude.ai connector 真呼叫 kbdb_graph_neighbors）：MCP→cypher→workflow 鏈全通、工具行為正確；卡在 workflow 內 http_request 打 arcrun-kbdb.leo21c.workers.dev 回 1042＝leo21c 的 http_request 零件 worker 是舊版（無 global_fetch_strictly_public flag；上游 toml 07-14 已帶，uncle6 有、leo21c 未跟）。非本 PR 問題。關單條件：leo21c 重部 http_request 零件（
builtins/http_requestwrangler deploy 或 acr update）後重測一發 200。附註：錯誤 next_actions 建議文案未涵蓋 1042 情境，小 UX 債記著。✅ e2e 全通關單（雲端總管實測）：kbdb_graph_neighbors subject=00-INDEX depth=2 → 26 鄰居含跨庫橋接（kb/00-INDEX、notes/00-INDEX）。
過程排雷兩枚：①leo21c http_request 舊版 1042（leo 重部解）②總管誤用 MCP push 推 registry canonical 版 → 「圖定義已失效」——實例部署正道＝arcrun-rag
workflows/*.local.yaml＋install/push-demo-workflow.sh（07-17 教訓再驗證），已用它修復。小 UX 債留檔：tool 回應的 hints 在 count=26 時仍顯「0 個鄰居」（hint 生成讀錯巢狀層 data.data.count），不影響資料正確性，後續小修。