ctx: The missing link between your codebase and your LLM. Context as Code (CaC) tool with MCP server inside.

CTX：AI コーディングコンパニオン

MCP を活用した開発ツールキット。AI がコードベース全体にアクセスできるようにします。


CTX とは？

CTX は、依存関係が一切ない、約 20 MB の単一バイナリです。Node.js も Python もランタイムも必要ありません。ダウンロードして、MCP クライアントに接続するだけで、AI と一緒にコーディングを始められます。

Claude Desktop、Cursor、 Cline、または MCP 互換クライアントに接続すると、AI はプロジェクト全体のファイルを直接読み取り、書き込み、検索、変更できるようになります。

CTX は Claude Desktop を念頭に設計されており、Claude Desktop との組み合わせで最高の性能を発揮します。Claude によるコードの深い理解と、CTX のファイルシステムツール、カスタムコマンド、複数プロジェクト対応を組み合わせることで、シームレスな開発体験を実現します。コードベース全体を把握したシニア開発者がすぐ隣にいるような感覚です。

目次

• 主な機能
• クイックスタート
• 仕組み
• ユースケース
• 完全なドキュメント
• ライセンス

主な機能

🛠 MCP サーバー — AI がプロジェクト内で直接開発

CTX には、強力なファイルシステムツールを備えた MCP サーバーが組み込まれています。

• ファイルの読み書き — AI がコードを直接作成、変更、分析します
• コードベース全体の検索 — コンテキスト行付きのテキスト検索と正規表現検索
• PHP 構造分析 — クラス階層、インターフェース、依存関係をひと目で確認
• ディレクトリの探索 — パターン、日付、サイズ、内容によるスマートな絞り込み

⚡ カスタムツール — あらゆるコマンドを AI ツールに変換

プロジェクト固有のコマンドを定義し、AI が MCP 経由で実行できるようにします。

tools:
  - id: run-tests
    description: "Run project tests with coverage"
    type: run
    commands:
      - cmd: vendor/bin/phpunit
        args: [ "--coverage-html", "logs/coverage" ]

  - id: deploy
    description: "Deploy to staging"
    type: run
    schema:
      type: object
      properties:
        branch:
          type: string
          default: "main"
    commands:
      - cmd: ./deploy.sh
        args: [ "{{branch}}" ]

テスト、マイグレーション、リンター、デプロイなど、ターミナルで実行できるものなら何でも、AI が実行できます。

📁 複数プロジェクトの開発

複数のマイクロサービスを同時に扱えます。AI はすべてのプロジェクトを認識し、複数のプロジェクトにまたがる機能を開発できます。

projects:
  - name: backend-api
    path: ../backend
    description: "REST API service"

  - name: auth-service
    path: ../auth
    description: "Authentication microservice"

  - name: shared-lib
    path: ../packages/shared
    description: "Shared domain models"

セッションを開始し、利用可能なプロジェクトの一覧を AI に依頼すれば、複数のサービスにまたがる機能を 1 つの会話の中で開発できます。

🎯 スマートなコンテキスト生成

AI に必要なコンテキストを正確に定義できます。CTX はファイル、git diff、GitHub リポジトリ、URL などからコードを収集し、整理された Markdown ドキュメントに構成します。

documents:
  - description: User Authentication System
    outputPath: auth.md
    sources:
      - type: file
        sourcePaths: [ src/Auth ]
        filePattern: "*.php"
      - type: git_diff
        commit: "last-week"

📐 JSON Schema 対応の宣言的な設定

すべての設定は、完全な JSON Schema 対応の context.yaml で行います。AI アシスタントに設定を生成・変更してもらうこともできます。必要なことを説明するだけです。

ctx init    # Generate initial config
ctx generate  # Build context documents
ctx server  # Start MCP server

クイックスタート

インストール

Linux / WSL:

curl -sSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | sh

Windows:

powershell -c "& ([ScriptBlock]::Create((irm 'https://raw.githubusercontent.com/context-hub/generator/main/download-latest.ps1'))) -AddToPath"

Claude Desktop（または任意の MCP クライアント）に接続

最も簡単な方法は、OS を自動検出して MCP クライアントを設定することです。

ctx mcp:config

または、MCP クライアントの設定に手動で追加します。

{
  "mcpServers": {
    "ctx": {
      "command": "ctx",
      "args": [
        "server"
      ]
    }
  }
}

特定のプロジェクトを指定する場合：

{
  "mcpServers": {
    "ctx": {
      "command": "ctx",
      "args": [
        "server",
        "-c",
        "/path/to/project"
      ]
    }
  }
}

これで完了です。AI アシスタントは MCP 経由でプロジェクトにフルアクセスできるようになります。

オプション：コンテキストドキュメントを生成

コピー＆ペーストのワークフロー向けに静的なコンテキストファイルも生成したい場合は、次のようにします。

cd your-project
ctx init       # Create context.yaml
ctx generate   # Build markdown contexts

仕組み

CTX は、相互に補完する 2 つのモードで動作します。

MCP サーバーモード — AI がコードベースをリアルタイムで操作します。

AI Assistant ←→ CTX MCP Server ←→ Your Project Files
                     ↕
              Custom Tools (tests, deploy, lint...)
              Multiple Projects
              Context Documents

コンテキスト生成モード — あらゆる LLM 向けの構造化ドキュメントを作成します。

context.yaml → Sources → Filters → Modifiers → Markdown Documents

ユースケース

🔧 AI を活用した開発（MCP）

CTX を Claude Desktop または Cursor に接続します。会話から離れることなく、コードベースの調査、アーキテクチャの把握、新機能の作成、テストの実行、問題の修正を AI に依頼できます。

🏗 複数サービスにまたがる機能開発

複数のマイクロサービスにまたがる機能を開発していますか？すべてのプロジェクトを登録すれば、AI はあるサービスのコードを読み取り、共有モデルを理解したうえで、スタック全体に変更を実装できます。

📝 コードレビュー向けコンテキスト

最近の git diff、関連するソースファイル、アーキテクチャの概要を含むコンテキストドキュメントを生成します。レビュアーや AI アシスタントと共有すれば、十分な情報に基づいた綿密なレビューが可能です。

🚀 オンボーディング

新しいチームメンバーが加わりましたか？アーキテクチャ、主要なインターフェース、ドメインモデルなど、プロジェクトの包括的な概要を数秒で生成できます。 その後、AI はコードベース全体のコンテキストを踏まえて質問に回答できます。

📚 ドキュメントの生成

php-signature のような修飾子を使って CTX にソースコードを指定し、API の情報を抽出してから、AI に包括的なドキュメントを生成させます。

ドキュメント全文

すべての機能や設定オプションを含むドキュメント全文はこちらです。

https://docs.ctxllm.com

コミュニティへの参加

コミュニティでできること：

• 💡 設定やワークフローを共有・発見できます
• 🛠️ セットアップや高度な使い方についてサポートを受けられます
• 🚀 AI 開発のワークフローを紹介できます
• 📢 新しいリリースの情報をいち早く入手できます

---

ライセンス

このプロジェクトは MIT License の下でライセンスされています。