Context9 —— リアルタイムドキュメントを Agent のコンテキストへ

January 29, 2026 · View on GitHub

カバー

Context9 —— リアルタイムドキュメントを Agent のコンテキストへ

最新同期 · ローカルファースト · 低ハルシネーション

X · Discord · Issues

Apache 2.0 licensed MCP

https://github.com/user-attachments/assets/553ab8a2-5227-42fa-a8bd-692cd13c0b96

なぜ Context9 なのか？

  • 🎯 最新ドキュメント：ドキュメントをリアルタイムで同期し、AI Agent のハルシネーションを大幅に低減します。
  • 🔐 ローカルファースト：完全オープンソース。自分のサーバーにデプロイでき、プライベートな知識を安全に利用できます。
  • ⚙️ 使いやすい Web UI：Context9 パネルからリポジトリや API Key の権限を簡単に管理できます。

Context9 は何をするのか

Context9（Context Mine） は MCP（Model Context Protocol）サーバーです。ローカル環境にデプロイすることで、最新のドキュメントを安全に Agent へ提供し、LLM のハルシネーションを抑制します。

overview

Context9 のインストール

Context9 サーバーの起動

docker run -d \
    --name context9 \
    -p 8011:8011 \
    --restart unless-stopped \
    ghcr.io/prism-shadow/context9:latest \
    python -m context9.server --github_sync_interval 600

または、Context9 が使用するポートを指定することもできます。

docker run -d \
    --name context9 \
    -e CONTEXT9_PORT=<port> \
    -p <port>:<port> \
    --restart unless-stopped \
    ghcr.io/prism-shadow/context9:latest \
    python -m context9.server --github_sync_interval 600

Context9 の設定

Context9 にログイン

http://<server_ip>:8011/ にアクセスして Context9 にログインします。

  • デフォルトユーザー名：ctx9-admin
  • デフォルトパスワード：88888888

初回ログイン後、必ずパスワードを変更してください。

login

リポジトリの追加

リポジトリの owner、リポジトリ名、ブランチを入力して、必要なリポジトリを追加します。

  • プライベートリポジトリの場合は GitHub Token が必要です。

Context9 テンプレートを使用したリポジトリのエクスポート＆インポート

  • リポジトリのエクスポート（Export Repos）：Export Repos ボタンをクリックすると、現在のリポジトリ設定をローカルテンプレートとしてエクスポートでき、後から簡単に再利用できます。
  • リポジトリのインポート（Import Repos）：Import Repos ボタンをクリックすると、Context9 テンプレートをリポジトリ設定にインポートできます。Context9 では、参考や利用のためにいくつかの テンプレート も提供しています。

repo

API Key の追加

Context9 にアクセスするための API Key を生成します。

api_key

API Key を生成した後、その Key がアクセス可能なリポジトリを設定してください。

key2repo

Context9 のテスト（任意）

MCP Inspector に Context9 サーバーの IP と API Key を入力して、設定をテストできます。

inspector

Agent への Context9 の統合

Context9 をデプロイすると、プライベートおよびパブリックな最新コードドキュメントを Agent にシームレスに統合できます。Cursor や Claude Code などのツールから接続可能です。

Cursor へのインストール

手順：Settings → Cursor Settings → Tools & MCP → Add a Custom MCP Server

以下の設定を ~/.cursor/mcp.json に貼り付けてください。

プロジェクト単位で設定したい場合は、プロジェクトディレクトリに .cursor/mcp.json を作成してください。

{
  "mcpServers": {
    "Context9": {
      "url": "http://<server_ip>:8011/api/mcp/",
      "headers": {
        "Authorization": "Bearer <CTX9_API_KEY>"
      }
    }
  }
}

Claude Code へのインストール

以下のコマンドを実行して、Context9 を Claude Code に追加します。

claude mcp add --transport http Context9 http://<server_ip>:8011/api/mcp/ --header "Authorization: Bearer <CTX9_API_KEY>"

Context9 利用のおすすめ設定

Context9 を毎回明示的に指定しなくても使えるよう、以下を推奨します。

  • Claude Code では CLAUDE.md を使用
  • Cursor や CodeX などでは AGENTS.md を使用
  • Cursor に Rule を追加

Claude Code で CLAUDE.md を使用

CLAUDE.md に以下を追加してください。

- 常に Context9 経由で必要なドキュメントを取得する

Cursor / CodeX 用 AGENTS.md

AGENTS.md に以下のようなルールを追加します。

Rules:
- 常に Context9 経由で必要なドキュメントを取得する

Cursor に Rule を追加

手順：Setting → Rules and Commands → Add Rule

例：

明示的に指示されていなくても、常に Context9 MCP を使用して必要なドキュメントを取得する。

Context9 でのドキュメント運用

エントリードキュメント（Spec）の設定

Context9 がリポジトリ内のドキュメントを正しく検出・インデックスするために、各リポジトリには Spec ドキュメントを用意してください。

デフォルトでは、リポジトリのルートに spec.md を配置します。

your-repo/
├── spec.md          ← 仕様書エントリーポイント
├── README.md
├── docs/
│   └── ...
└── ...

ファイル名やパスを変更する場合は、リポジトリ設定も忘れずに更新してください。

ドキュメント内での相対リンク

MCP やインデックスの仕組みを意識する必要はありません。通常のリポジトリ相対パスでリンクを記述するだけで問題ありません。

例：

## 関連ドキュメント
- [詳細ガイド](docs/detailed-guide.md)
- [API リファレンス](guides/api-reference.md)
- [FAQ](faq.md)

これらのリンクが有効であれば、Context9 は以下を自動で行います。

  • ドキュメントの検出
  • 正確なインデックス作成
  • AI Agent へのリアルタイム提供

ソースコードから Context9 をデプロイ

展開

GUI デプロイ

要件

  • Python >= 3.10
  • Node.js >= 18
  • リポジトリアクセス（公開または認証 Token）

Context9 リポジトリのクローン

git clone https://github.com/Prism-Shadow/context9.git && cd context9

Python 環境のセットアップ

uv sync
uv sync --dev

フロントエンド依存関係のインストール

cd gui
npm install
cd ..

環境変数の設定

  • CONTEXT9_PORT（任意）：Context9 サービスのポート（デフォルト 8011）
CONTEXT9_PORT=xxxx

GUI をビルドしてサーバー起動

uv run python scripts/start.py --github_sync_interval 600
uv run python scripts/start.py --github_sync_interval 60

CLI デプロイ

要件

  • Python >= 3.10
  • リポジトリアクセス権限

ライセンス

本プロジェクトは Apache License 2.0 のもとで公開されています。詳細は LICENSE を参照してください。

謝辞

本リポジトリは context7 から恩恵を受けています。素晴らしい成果とインスピレーションを提供してくださった作者およびコントリビューターの皆様に感謝します。

⭐ Star 履歴

Star History Chart