registree

コーディングエージェント向けの幻覚防止クラスレジストリ。MCP 経由で提供されます。

コーディングエージェントはコンストラクタのシグネチャを記憶から推測します — 存在しないキーワード、必須引数の欠落 — そしてその推測の代償として TypeError とデバッグの往復を支払うことになります。registree はその推測を排除します: ast でコードベースを走査し（インポートは一切行いません）、すべてのクラス定義のレジストリを構築し、MCP ツールとして提供するため、エージェントは呼び出しを書く前にシグネチャを検証できます。

すべてのツールに通底する2つの原則:

• 名前はリストにマッピングされる。 重複したクラス名はすべての定義を返します。サーバーが暗黙的に最初の一致を選ぶことはありません。

• 正直さは自信に勝る。 自由形式のコンストラクタ（**kwargs、Pydantic の extra=/alias=）は、その契約を未知として報告し、回答を装った空のリストを返すことはありません。

仕組み

1. スキャン — ソースツリーに対する AST 走査で、すべてのクラスを抽出します: コンストラクタパラメータ（**kwargs と位置専用引数を含む）、デフォルト値付きの型付きフィールド、継承、docstring。分類は推移的です: プロジェクト自身の基底クラスを経由するモデルも、Pydantic モデルとして認識されます。

2. 提供 — レジストリは JSON としてキャッシュされ、MCP stdio 経由で公開されます。自己維持型です: 初回使用時に生成され、スキャン対象ファイルがキャッシュより新しい場合は再生成されます。

3. 回答 — エージェントは推測する代わりに、使用時点でレジストリに問い合わせます。

Related MCP server: Lore MCP Server

MCP ツール

インストール

uv を使えばインストールは不要です — MCP クライアントは uvx で起動します。CLI で直接使用する場合:

uv tool install registree   # or: pip install registree

Python 3.12+ が必要です。

エージェントへの組み込み

任意の MCP クライアント、JSON 設定形式:

{
  "mcpServers": {
    "registree": {
      "command": "uvx",
      "args": ["registree", "serve", "--root", "/path/to/your/project"]
    }
  }
}

--root を省略すると、クライアントがサーバーを起動したディレクトリが提供されます。ほとんどの MCP クライアントでは、これがプロジェクトルートになります。

• クイックスタート（任意のエージェント）: docs/quickstart.md

• Claude Code のセットアップ、フック統合を含む: docs/claude-code.md

エージェント互換性

MCP ツールは任意の MCP クライアントで動作します — Claude Code、Claude Desktop、Cursor、Windsurf、Cline、Zed、VS Code Copilot エージェントモード、Gemini CLI、その他 stdio で MCP を話すすべてのクライアント。構造化されたツール出力は、テキストコンテンツのみを読むクライアントではグレースフルに劣化します。

フックアダプタ（hook-check、hook-regen）は Claude Code のフックプロトコルを対象としています。これは、保留中のファイル編集をインターセプトし、書き込みが確定する前にモデルにアドバイザリフィードバックを渡すことができます — MCP レイヤーだけでは提供できない決定的なチェックポイントです。docs/claude-code.md を参照してください。

そのプロトコルは広がりつつあります: VS Code Copilot エージェントモード（プレビュー）は同じ形式を読み取ります — 同じイベント、同じ stdin JSON、さらには .claude/settings.json まで — そしてアダプタはその camelCase フィールド名を許容します。Codex CLI と Gemini CLI は十分に近いフック契約を使用しており、移植は簡単です。ファイル編集を適用前にインターセプトできないフックシステムを持つエージェント（Cursor、モデルフィードバックなしの Windsurf、フック未実装の Zed）でも、完全な MCP ツールセットは利用できます — フックは、プラットフォームがサポートする場合に決定的なレイヤーを追加するだけです。

CLI

同じエンジンを直接利用できます:

registree gen                 # build the registry
registree conflicts           # duplicate names: accepted layering vs smells
registree usages SomeClass    # every usage, alias-aware — run before renames
registree hook-check          # Claude Code PreToolUse adapter (advisory)
registree hook-regen          # Claude Code PostToolUse adapter (debounced)

registree conflicts は、真のスメルである重複名に対してのみ非ゼロで終了します — 許容される ORM/ドメインのレイヤードペアは合格します — そのため、初日から CI に組み込んでも安全です。

レジストリキャッシュ

デフォルトでは .registree/registry.json に配置されます — .registree/ を .gitignore に追加してください。これに触れるすべてのコマンドは --registry-path を受け付け、任意の場所に配置できます。相対パスはプロジェクトルートにアンカーされます。

開発

uv sync            # creates .venv, installs deps + dev tools
uv run pytest      # includes a real stdio JSON-RPC handshake test
uv run mypy src tests
uv run ruff check .
uv run black --check .

サーバーを直接実行します（stdio で MCP を話し、EOF で終了します）:

uv run registree

ライセンス

MIT