Skip to content

docs: define optional MCP feedback interface #5

Description

@lipluscodex

背景

Neuron Graph RAG をMCP対応AIから利用する可能性がある。ただし、現時点ではMCP採用や独立サーバー運用は確定していない。コアの標準ライブラリのみという性質を維持したまま、検索結果を実際に利用したAIが成功信号を返せる接続契約を先に定義する。

方針

  • MCPはコア必須依存にしない
  • 同一リポジトリ内の任意アダプター境界として設計する
  • まず文書化されたインターフェース契約のみを追加する
  • 実装、別リポジトリ化、認証方式、リモート配備は後続判断とする

スコープ

  • search の入出力契約
  • record_source_use の入出力契約
  • record_outcome の入出力契約
  • retrieved / selected / validated / used の段階定義
  • used のみ即時強化へ接続する規則
  • corrected / rolled_back など遅延結果の扱い
  • trace_id、node_id、列挙値の検証要件
  • コアと任意アダプターの依存境界
  • 独立リポジトリへ分離する条件

スコープ外

  • MCPサーバーの実装
  • MCP SDKの必須依存化
  • 認証・認可方式の確定
  • 公開エンドポイントの配備
  • v0.1.0 Releaseの作成

完了条件

  • リポジトリ内にMCP接続契約の設計文書がある
  • 各ツールの意味、入力、出力、失敗条件が明示されている
  • 検索されたことと実際に使われたことが分離されている
  • 現在のNGR APIとの対応関係が明示されている
  • READMEまたは関連設計文書から到達できる
  • Wikiの再構成方針にも今回の判断が反映されている

Metadata

Metadata

Labels

doneImplementation phase finished; awaiting orchestration.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions