github rag mcp replacement compatibility

github-rag-mcp 代替互換性スパイク

Question

Neuron Graph RAG が github-rag-mcp の代替候補になれるかを、D1 のテスト用拡張なしでどの範囲から検証するか。

Current resolution

最初に、読み取り専用の GitHub source adapter とローカル index を用いる互換性スパイクを実施する。対象は一つの public repository と既存 search の最小入出力契約に限定し、同一 query に対する検索結果、根拠、更新追随を比較する。

このスパイクは本番置換、MCP remote deployment、認証、D1 の拡張、または production default の変更を承認しない。結果が契約と比較基準を満たす場合だけ、次段の MCP adapter と運用面を別判断する。

Edges

• depends on none
• refines none
• supersedes none
• conflicts with none
• informs none

Background

github-rag-mcp は GitHub webhook / API、Cloudflare Worker、Vectorize、D1、Workers AI により更新と検索を提供している。一方 NGR は SQLite 上の hybrid retrieval、typed graph、path explanation、trace-credited feedback を実装しているが、GitHub source adapter、MCP server、認証、transport、remote deployment は未実装である。

D1 の容量不足は実データ evaluation の阻害要因だが、代替可否は D1 を評価用に増やさず、GitHub を読み取り専用 source とする小さな比較から判定できる。

Constraints

• D1 の source document、relation edge、repository、collection をテスト目的で追加しない。
• GitHub source は public repository 一つに限定し、write、webhook 登録、production index 更新を行わない。
• comparison は同一 query と明示した expected source を用い、NGR の graph signal と既存 search の優劣を事前に仮定しない。
• NGR の default、github-rag-mcp の production service、MCP authentication / transport / remote deployment を変更しない。
• NGR の source adapter は core API の上に置き、GitHub 固有の取得・正規化を core に埋め込まない。

Conclusion

NGR は現時点で github-rag-mcp の代替ではない。まず一つの public repository に対する読み取り専用の互換性スパイクを実施し、検索、根拠、更新追随の比較結果から代替候補として進めるかを判定する。

Related

• Issue #5 - NGR optional MCP feedback interface の既存契約。
• github-rag-mcp - 比較対象の検索・更新サービス。
• D1 single-corpus decision - D1 をテスト目的で拡張しない制約。
• Decision Structure index - entry format、ownership、lifecycle。