ワークスペースのインデックス作成、検索、計画、およびレビューワークフロー用のエージェント・アグノスティック・モデル・コンテクスト・プロトコル(MCP)サーバー、コーデックスやその他のOpenAIパワード・エージェントにうまく機能するセットアップ・パス。

詳細はこちら 初心者からスタートします。 ツイート クライアント固有のセットアップヘルプが必要な場合は、docs/MCP CLIENT SETUP.md を参照してください。 ツイート Windows上でいる場合は、docs/WINDOWS DEPLOYMENT GUIDE.md を参照してください。 ツイート 古い計画と移行ノートが必要な場合は、 docs/archive/INDEX.md に住んでいた履歴書。

OpenAI/コーデックスショーケース

このプロジェクトがOpenAIスタイルのエージェントワークフローで実証されているものを見たい場合は、以下を実行します。

• ローカルワークスペースのインデックス作成と検索
• 同じMCPサーバーの上にレイヤーされたワークフローの見直しと計画
• 初心者向けインストールとクライアント設定
• Windowsのサポートとコピーペーストの設定例
• セルフセットアップのためのAIエージェントフレンドリーな指示

##このマターの理由

• OpenAIを搭載したエージェントが実際のワークスペースに接続し、すぐにツールを使用して起動できる方法を示します。
• 1つのMCPサーバーでリトリーバール、レビュー、および計画を1つのMCPサーバーで結合します.

Context Engine MCP Server

A local-first, agent-agnostic Model Context Protocol (MCP) server for workspace indexing, retrieval, planning, and review workflows, with a setup path that works well for Codex and other OpenAI-powered agents.

New here? Start with the beginner quick start below.

If you want client-specific setup help, see docs/MCP_CLIENT_SETUP.md.

If you are on Windows, see docs/WINDOWS_DEPLOYMENT_GUIDE.md.

Historical docs live in docs/archive/INDEX.md if you need the old planning and migration notes.

OpenAI / Codex Showcase

If you want to see what this project demonstrates for OpenAI-style agent workflows, start here:

• Local workspace indexing and retrieval
• Review and planning workflows layered on top of the same MCP server
• Beginner-friendly install and client setup
• Windows support and copy-paste setup examples
• AI-agent-friendly instructions for self-setup

Why This Matters

• It shows how an OpenAI-powered agent can connect to a real workspace and start using tools right away.
• It combines retrieval, review, and planning in one MCP server instead of relying on one-off scripts.
• It gives both humans and AI agents a simple, repeatable setup path, which makes demos and onboarding easier.

Fastest demo path:

npm install
npm run build
codex mcp add context-engine -- node dist/index.js

Then in Codex, confirm the tools are visible and try:

use semantic_search to find authentication logic

Beginner Quick Start

If you just want to get Context Engine running locally, follow these steps:

1. Install Node.js 18+.
2. Clone this repository and open it in a terminal at the repo root.
3. Install dependencies:

npm install

4. Build the server:

npm run build

5. Run the verification checks:

npm run verify

6. Start the MCP server:

node dist/index.js

By default, Context Engine now resolves the workspace like this:

• explicit --workspace wins
• otherwise it uses the current folder
• if you launched from a nested folder inside a git repo, it falls back to the nearest git root
• if no git root exists, it stays on the current folder and logs a warning

On first run, if the index is missing or stale, startup can kick off background indexing automatically. The server still starts first, but the first query may be slower until indexing finishes.

Connect It To Your MCP Client

The server speaks MCP over stdio, so most clients can launch it with the same command.

First-Time Setup vs Daily Use

Use this mental model:

1. First-time setup: Register the MCP server once in your client.
2. Daily use: Open any repo and let the server resolve the workspace automatically.
3. Override only when needed: Pass --workspace if the client launches from the wrong folder or you want a different repo on purpose.

Codex CLI