CodeKB は、AWS Labs が GitHub で公開した OSS(Apache-2.0)で、2026年11月21日に公開が告知されました。複数のリポジトリを解析し、関数ごとに「何をしているか」を業務の言葉で説明した索引を作ります。その索引と呼び出しの流れを、MCP で AI エージェントに渡します。既存システム(ブラウンフィールド)の改修で、どのリポジトリが関係するかを人が選ばなくて済むようにする道具です。
WHAT CHANGES何が変わるか
関係するリポジトリを人が選ぶのをやめ、CodeKB が探す
いままで
人がリポジトリを選んでエージェントに渡す
- どのリポジトリが関係するかを人が判断
- 見落としたらそれきり
CodeKB
AWS が公開した OSS(Apache-2.0)
- 作業を説明すると関係するリポジトリを選ぶ
- コードが何をするかの理解をエージェントに渡す
30秒でわかる CodeKB(2026-11-22時点)
- ・何ができる:作業を説明すると、組織の中から関係するリポジトリとコードを探し、呼び出しの流れごとエージェントに渡す
- ・仕組み:tree-sitter で呼び出しグラフを作り、Bedrock の LLM で関数ごとに業務の言葉の説明を書いて、意味で探せる索引にする
- ・使い方:Web UI で検索と会話、Kiro や Claude Code からは MCP の14の道具で
- ・前提:自分の AWS アカウントと、Bedrock の Claude と Titan の利用権が要る。star は 121(11月22日)
MCP サーバーそのものの作り方は MCPサーバーの作り方2026年完全ガイド:TypeScript・Python両対応チュートリアル にまとめています。この記事は CodeKB の仕組みと、動かす前に確かめることに絞ります。
CodeKB とは:既存コードの「理解」を AI エージェントに渡す
CodeKB は、コードの文字列を索引にする道具ではなく、コードが何をするかの説明を索引にする道具です。 README は「Not code indexing. Code understanding.」と書いています。
README の問題意識は、ブラウンフィールドの開発で AI を使う人がいまやっていることです。作業に関係しそうなリポジトリを人が選んで作業場所に取り込み、エージェントに渡して「見落としが無いことを祈る」。システムがどうつながっているかの知識は、組織の中の多くの人と、数百から数千のリポジトリに散らばっていて、1人の人もエージェントも全体を把握していない、という見立てです。
公開を告知した Masao Kanamori さん(@masaosaan)は、AI-DLC の取り組みなどから分かった、既存システムの開発で必要になる既存コードの理解を AI で助ける道具だと書いています。README は用途を影響分析に限らず、計画、機能開発、デバッグ、リファクタリング、コードレビュー、モダナイゼーションまで挙げています。
できることは5つです。
| 機能 | 中身 |
|---|---|
| Space Overview | コードベースの業務の概要・アプリの構成・技術スタック・デプロイの構成を Markdown で生成 |
| 意味で探す検索 | 「支払いはどこで承認される?」のように、キーワードでなく意図でコンポーネントを探す |
| Agent Hopper | 解析したコードに基づいて答える、リポジトリを知っている会話エージェント。変更が何を壊すかを考える Impact Analysis のモードがある |
| Hyperspace | 関係するリポジトリをまとめ、検索・会話・概要を1つのシステムとして扱う |
| MCP の道具 | 同じ検索と分析を、IDE や AI アシスタント(Kiro や Claude Code など)に MCP で渡す |
上は README のデモの一コマです。サンプルの EC アプリに「注文はどこで作られ、チェックアウトはどこで完了する?」と尋ねると、CheckoutService.submit などのメソッドが、何をしているかの説明つきで返っています。
CodeKB の仕組み:関数ごとの説明と呼び出しグラフ
CodeKB の中心は、呼び出しグラフの上に「その関数が呼び先を通じて何を成し遂げるか」を業務の言葉で書いた索引です。 README は、コードベースの理解を5つの段階で作ると説明しています。
HOW IT BUILDS UNDERSTANDING理解の作り方
関数ごとに業務の言葉で説明を書き、意味で探して呼び出しの流れを辿る
-
スペースを追加
Git の URL か zip。S3 に保管
-
tree-sitter で解析
関数・クラスを取り出し呼び出しグラフを作る
-
Bedrock で説明
呼び先も含め業務の言葉で。秘密情報は先に伏せる
-
意味で検索
Titan で埋め込み S3 Vectors へ。グラフを辿る
-
差分だけ更新
変わったファイルと、その呼び元だけ説明し直す
- スペースを追加する:Git の URL か zip を渡すと、クローンか展開をして、写しを S3 に保管する。保存した Git のトークンは KMS の鍵で暗号化する
- 深い文脈を取り出す:tree-sitter で関数・メソッド・クラス・モジュール・変数を取り出し、それらの呼び出しグラフを作り直す
- 業務の振る舞いの索引を作る:Bedrock の LLM が、各関数を、その関数が呼ぶコードと合わせて業務の言葉で説明する。先に Bedrock の Guardrail で秘密情報や個人情報を伏せ、Titan で説明を埋め込んで S3 Vectors に入れる
- 振る舞いで探し、グラフを辿る:意図で見つけたコンポーネントから、ソース・呼び元・呼び先を辿り、1件の検索結果をシステムの中の経路に広げる
- 作り直さずに最新に保つ:Git のスペースを更新すると、変わったファイルだけを解析し直し、呼び出しグラフを逆に辿って、変わったコードを説明に含んでいた呼び元を説明し直す。ほかは使い回す。更新に失敗したら、前の版の索引で検索できる
説明を「呼び先も含めて」書くのが要点です。関数の名前やコメントではなく、その関数が下で何を呼んで何を成し遂げるかを説明にするので、「注文を確定する処理」と尋ねて、名前に order が入っていない関数も見つけられる、という設計です。
どこで動くか
WHAT RUNS WHEREどこで動くか
コンテナ1つと、自分の AWS アカウントの中で完結する
-
使う人・エージェント
Web UI で検索・会話。Kiro や Claude Code は MCP で
-
CodeKB のコンテナ
Web UI・REST API・MCP サーバーを1つで。手元か ECS Fargate
-
自分の AWS アカウント
Bedrock・S3・S3 Vectors・KMS・CloudWatch Logs
CodeKB は、Web UI・REST API・MCP サーバーを1つのコンテナで提供します。保存するものも呼び出すモデルも、すべて自分の AWS アカウントの中です。
| 部品 | 役割 |
|---|---|
| Amazon Bedrock | 説明を書く LLM(Claude)、秘密情報を伏せる Guardrail、Titan の埋め込み |
| Amazon S3 Vectors | 説明の埋め込み |
| Amazon S3 | 知識ベース・ソースの写し・Git のトークン |
| AWS KMS | Git のトークンを暗号化する鍵 |
| Amazon CloudWatch Logs | ログ(任意) |
対応言語は Python、JavaScript、TypeScript、Java、Kotlin、Go、Rust、C、C++、C#、PHP、Ruby、Terraform、Dart の14です。ほかの言語のファイルは数えるだけで解析しません。テスト、ビルドの出力、AI エージェント用のフォルダは既定で除外されます。
CodeKB の MCP ツール:Kiro や Claude Code から使う
CodeKB の MCP サーバーは、意味で探す・名前で探す・依存と呼び出しを辿る・スペースを選ぶ、の14の道具を持っています。 IDE や AI アシスタントは、この道具でコードの理解を取りにいきます。
| 道具 | 役割 |
|---|---|
get_component_from_description |
自然文の説明に合うコンポーネントを探す。最初の一手 |
find_component・search_components・list_components |
名前の完全一致・ワイルドカード・種類で探す |
show_component |
コンポーネントのソースとメタデータを見る |
show_dependencies |
出ていく依存を見る。raw_output=true で入ってくる依存(影響分析)も |
trace_flow・get_call_graph_with_source |
関数からの呼び出しを辿る。呼び出しグラフを関数のソースつきで返す |
get_stats・load_knowledge_base |
解析したコードベースの要約、保存した知識ベースの確認 |
list_spaces・get_space_details・list_hyperspaces・get_hyperspace_details |
スペースとハイパースペースを選ぶ |
ドキュメントが勧める最初の手順は、list_spaces でスペースを選び、get_component_from_description で探したい振る舞いを説明し、返ってきたコンポーネントの ID を show_component に渡す、です。変更の影響を見るときは、show_dependencies を raw_output=true で呼び、入ってくる依存も含めます。
接続は、MCP の設定に URL を書くだけです。Kiro ならワークスペースの .kiro/settings/mcp.json に書きます。手元で動かした場合の URL は http://localhost:8000/mcp/mcp です。
{
"mcpServers": {
"aws-codekb": {
"url": "http://localhost:8000/mcp/mcp"
}
}
}
README のもう1つのデモでは、Kiro が CodeKB の道具を使って、チェックアウトが注文を作る場所を探し、CheckoutService.submit に依存するものを挙げてから、空のチェックアウトを拒む処理を足しています。
CodeKB を動かす前に確かめること:AWS の前提・費用・認証
CodeKB はローカルだけでは完結せず、自分の AWS アカウントと Bedrock の利用権が前提です。 動かし方は、チームで共有する AWS への配置(CDK・推奨)と、1人で試す手元での起動の2つです。
BEFORE YOU DEPLOY導入の前に
動かす前に確かめる3点
-
1.Bedrock の利用権
Claude のモデルと Titan Text Embeddings V2 を使えるリージョンか
-
2.CDK の既定の台数
既定のステージは 4vCPU・16GB の Fargate を10台起動する
-
3.手元で動かすときの認証
サインインを切るので、ポートは 127.0.0.1 から出さない
| 動かし方 | 向く場面 | 中身 |
|---|---|---|
| AWS に CDK で配置(推奨) | チームでサインインつきの共有の環境が要る | ECS Fargate・CloudFront・AWS WAF・Amazon Cognito を自分のアカウントに作る |
| 手元で試す | 1人で動かす | サインインなし。localhost からだけ届く |
費用:使う AWS のサービスの料金がかかります。解析のたびの主な費用は Bedrock で、その多くは説明を書く処理です。解析が終わると、スペースに処理ごとのトークン使用量が出ます。安くするには、安いモデルを選ぶか、業務との関係が薄いコンポーネントを飛ばす解析の選択肢を使います。CDK の配置では、既定のステージ(alpha)と dev 以外のステージが、4vCPU・16GB の Fargate のタスクを10個起動します。ドキュメントは、配置する前にこの台数を見直すよう強調しています。
認証:手元で動かす場合はサインインが無効で、リクエストは認証されません。ドキュメントは、ポートに届く人は誰でも別の利用者として振る舞えるので、ポートを 127.0.0.1 だけに公開したままにするよう求めています。ほかの人が届く場所に置くなら、CDK での配置を使います。
手元で試す手順は、ドキュメントでは次のとおりです。AWS CLI v2(S3 Vectors に対応したもの)と Docker が要り、Bedrock で Claude のモデル(ドキュメントの既定は Claude Opus 4.6)と Titan Text Embeddings V2 を使えるリージョンを選びます。
git clone https://github.com/awslabs/codekb && cd codekb
cp .env.example .env # <...> を自分のアカウントの値に置き換え、CODEKB_REQUIRE_AUTHENTICATION=false にする
./infra/cli/setup_aws.sh # S3・S3 Vectors・KMS・Bedrock Guardrail・IAM ポリシーを作る
./scripts/run-container.sh # 127.0.0.1:8000 で起動
setup_aws.sh は、最後に表示する IAM ポリシーの付与コマンドと、Guardrail の ARN を .env に入れる作業を求めます。起動したら http://localhost:8000 で New space を押し、Git の URL か zip を渡すと、Analyzing → Summarizing → Ready と進みます。この記事では、AWS のリソースを作る手順から先(解析・検索・MCP の接続)は動かしておらず、未検証です。上の手順と画面は公式ドキュメントと README のデモによります。
README が挙げる、ほかの制限も押さえておきます。
・スペースは1つのブランチかタグの、1つのコミットの写し。コミットの履歴は索引にしない。Git のスペースは Refresh space で更新する
・大きさの上限:解析するソースは最大1万ファイル(超えた分はログの警告だけで飛ばす)、10MB を超えるファイルは飛ばす、Git のクローンは5分以内、zip は 500MB まで(展開後 5GB まで)
・裏の処理はサーバーの中で動く:既定では1プロセスで同時に32件まで。超えると HTTP 429 を返す。途中で再起動すると、そのスペースは処理中のまま残る
・TLS の終端とリクエスト数の制限は持たない:プロキシやロードバランサーの後ろに置く。CDK の配置では CloudFront と AWS WAF が受け持つ
CodeKB とほかのコード理解の MCP・道具の選び方
CodeKB は「組織の多数のリポジトリを、業務の言葉で探せるようにする」チーム向けの道具で、手元の1つのリポジトリを素早く辿るなら、ほかの選択肢のほうが軽いです。 このサイトで扱った道具と並べます。
| 選択肢 | 何で理解するか | 動く場所・前提 | 向く人・場面 |
|---|---|---|---|
| CodeKB | LLM が関数ごとに書いた業務の言葉の説明+呼び出しグラフ。複数のリポジトリをまとめて扱える | 自分の AWS アカウント(Bedrock・S3 など)。チームで共有する配置が推奨 | 多くのリポジトリにまたがる既存システムを、チームでエージェントに理解させたい組織 |
| codebase-memory-mcp | tree-sitter で作る永続的なグラフの索引。複数のエージェントで共有 | 手元 | 1台の中で複数のエージェントに同じ索引を使わせたい人 |
| Serena | LSP による意味解析。シンボル単位で読み書き | 手元 | 手元のリポジトリで、ファイル全体を読ませずに編集させたい人 |
| graphify | tree-sitter の AST などで作る知識グラフ(コードのほか PDF なども) | 手元(Claude Code のスキル) | grep の代わりにグラフを辿らせたい Claude Code の利用者 |
CodeKB が他と違うのは、LLM が書いた説明を索引にする点です。そのぶん解析のたびに Bedrock の費用がかかり、AWS のアカウントが前提になります。手元で1つのリポジトリを扱うなら、codebase-memory-mcpとは|複数AIエージェントが索引を共有するMCPサーバー や、LSP を使う Serena MCPの使い方|セマンティック解析でClaude Codeのトークンを削る のほうが始めやすいはずです。
リポジトリの最初の開発のコミットは 2026年11月20日で、11月22日時点のコミットは24、タグはまだありません。README のバッジは 1.0.0 です。star は121(11月22日)で、告知でもフィードバックを募っている段階の OSS です。
参照ソース
・awslabs/codekb(公式リポジトリ・README)
・CodeKB docs: MCP
・CodeKB docs: Local setup
・CodeKB docs: Deploying to AWS
・CodeKB docs: FAQ
・CodeKB の公開の告知(X: @masaosaan)



