mcpField
G
gen-system Understand

gen-system Understand

ローカル
github.com/hpdkhoa開発ツール31 週間前に更新
リポジトリ

gen-system Understand について

gen-system Understand は、コードベースを調べるエージェント向けの読み取り専用 MCP サーバーです。複数言語の決定論的パーサーでコードの事実を抽出し、ローカルで動作してデータを外部へ送りません。

主な機能

  1. 01アーキテクチャとシンボルの検索
  2. 02呼び出しグラフと制御フローグラフ
  3. 03ソースとファイル内シンボル
  4. 04影響とルーチンの信念情報
  5. 05任意の信念修正

活用シーン

  1. 01ルーチン間の呼び出し追跡
  2. 02ルーチンの制御フロー確認
  3. 03リポジトリ内のシンボル検索

MCP 対応

MCP ツールを通じて、コードベースの構造、シンボル、グラフ、ソース、影響、信念情報を提供します。有効化すると信念修正ツールも利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "hpdkhoa-gen-understand": {
      "command": "npx",
      "args": [
        "-y",
        "gen-understand"
      ],
      "env": {
        "UNDERSTAND_MCP_BINARY": "<UNDERSTAND_MCP_BINARY>",
        "UNDERSTAND_MCP_CACHE": "<UNDERSTAND_MCP_CACHE>"
      }
    }
  }
}
起動コマンドnpx -y gen-understand
設定が必要な環境変数
UNDERSTAND_MCP_BINARYPath of a local understand-mcp binary; skips the download, for offline machines
UNDERSTAND_MCP_CACHEFolder for the downloaded binary; defaults to the user cache folder

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmgen-understand0.2.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

gen-understand

MCP サーバーとして動作する gen-system の Understand エンジンです。コードベースのアーキテクチャ、シンボル、呼び出しグラフ、制御フローグラフ、エフェクト、ソース、そして gen-system が各ルーチンについて保持している見解といった、パーサーによる事実を AI エージェントに提供します。これらの回答をモデルが生成することはありません。Go、コピーブックを含む COBOL、CA Gen、Java、TypeScript、Python 用の決定論的なパーサーが回答します。

このサーバーは読み取り専用です。ローカルで実行され、どこにもデータを送信しません。

使い方

Claude Code

claude mcp add gen-understand -- npx -y gen-understand --root /path/to/your-repo

Codex（~/.codex/config.toml）

[mcp_servers.gen-understand]
command = "npx"
args = ["-y", "gen-understand", "--root", "/path/to/your-repo"]

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "gen-understand": {
      "command": "npx",
      "args": ["-y", "gen-understand", "--root", "."]
    }
  }
}

ツール

architecture、search_symbols、call_graph、control_flow、source、file_symbols、effects、beliefs を利用できます。--allow-corrections を指定すると、correct_belief も利用できます。ツールの全一覧、フラグ、プロトコルの詳細については、 docs/mcp.md をご覧ください。

このパッケージの仕組み

サーバーは Go のバイナリです。初回実行時に、このパッケージは同じバージョンの gen-system リリースからお使いのプラットフォーム用のバイナリをダウンロードし、その SHA-256 をリリースの checksums.txt と照合してからキャッシュします。2 回目以降の実行はすぐに開始され、オフラインで動作します。Linux、macOS、Windows 向けに、x64 および arm64 のビルドが用意されています。

変数用途
UNDERSTAND_MCP_BINARYローカルの understand-mcp バイナリのパスです。ダウンロードをスキップします。オフラインのマシンで使用します
UNDERSTAND_MCP_CACHEダウンロードしたバイナリを保存するフォルダーです。デフォルトはユーザーのキャッシュフォルダーです

npm を使わない場合は、Go でバイナリをインストールできます：go install github.com/hpdkhoa/gen-system/generator/cmd/understand-mcp@latest。

ライセンス

Apache-2.0。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。