tuannvm/codex-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

647 stars 78 forks 품질 61 트렌드 25

Repository Install

OpenAI Codex CLI용 MCP 서버 래퍼를 통해 Claude Code가 Codex의 AI 기능을 직접 활용할 수 있습니다.

개요

Claude와 OpenAI의 Codex CLI 사이의 다리 역할을 하며 — AI 기반 코드 분석, 생성, 검토를 에디터에서 바로 확인할 수 있습니다. sessionId를 전달하면 첫 사용 시 세션이 생성되므로, listSessions가 (이 서버 인스턴스에 대해) 세션을 표시하고 이후 호출이 컨텍스트를 재개할 수 있습니다. - — npm i -g @openai/codex로 설치하거나 codex를 brew 설치하세요 - — codex 로그인 --api-key "your-key"를 실행해 인증하세요 - : Codex CLI가 threadId를 출력하면, 이 서버는 이를 콘텐츠 메타데이터와 structuredContent로 반환하고, 구조화된 응답을 위한 outputSchema를 광고합니다. - — 전체 도구 매개변수 및 응답 형식 - — 대화 작동 방식 - — 버전 호환성 및 CLI 세부 정보 - CODEX_MCP_CALLBACK_URI: 설정 시 Codex에 전달되는 정적 MCP 콜백 URI (callbackUri tool arg에 의해 덮어쓰임) - — Gemini CLI용 MCP 서버, 1M+ 토큰 컨텍스트, 웹 검색 및 미디어 분석 - — macOS용 Claude Code용 Dynamic Island — 여러 머신과 제공업체 간 세션을 실시간으로 모니터링

개요(AI 번역)

Claude와 OpenAI의 Codex CLI 사이의 다리 역할을 하며 — AI 기반 코드 분석, 생성, 검토를 에디터에서 바로 확인할 수 있습니다.

퀵 스타트

1. Codex CLI 설치

2. Claude 코드에 추가하기

3. 사용하기 시작해

원클릭 설치

도구

도구	설명
`codex`	세션 지원, 모델 선택, 구조화된 출력 메타데이터를 지원하는 AI 코딩 어시스턴트
`review`	미커밋 변경, 분기 또는 커밋에 대한 AI 기반 코드 검토
`websearch`	사용자 지정 가능한 결과 수와 검색 깊이를 가진 Codex CLI를 이용한 웹 검색
`listSessions`	활성 대화 세션 보기
`ping`	서버 연결 테스트
`help`	코덱스 CLI 도움말 받기

예시

코드 분석:

다중 턴 대화:

sessionId를 전달하면 첫 사용 시 세션이 생성되므로 listSessions가 표시됩니다 이 서버 인스턴스의 경우, 그리고 이후 호출이 컨텍스트를 재개할 수 있습니다.

코드 리뷰:

고급 옵션:

웹 검색:

요구 사항

Codex CLI v0.75.0+ — npm i -g @openai/codex 또는 [[[T7]로 설치하세요.
OpenAI API 키 — 인증을 위해 codex login --api-key "your-key" 실행하세요

코덱스 0.87 호환성

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Codex MCP Server

Bridge between Claude and OpenAI’s Codex CLI — get AI-powered code analysis, generation, and review right in your editor.

graph LR
    A[Claude Code] --> B[Codex MCP Server]
    B --> C[Codex CLI]
    C --> D[OpenAI API]

    style A fill:#FF6B35
    style B fill:#4A90E2
    style C fill:#00D4AA
    style D fill:#FFA500

Quick Start

1. Install Codex CLI

npm i -g @openai/codex
codex login --api-key "your-openai-api-key"

2. Add to Claude Code

claude mcp add codex-cli -- npx -y codex-mcp-server

3. Start Using

Ask codex to explain this function
Use codex to refactor this code for better performance
Use review to check my uncommitted changes

One-Click Install

Tools

Tool	Description
`codex`	AI coding assistant with session support, model selection, and structured output metadata
`review`	AI-powered code review for uncommitted changes, branches, or commits
`websearch`	Web search using Codex CLI with customizable result count and search depth
`listSessions`	View active conversation sessions
`ping`	Test server connection
`help`	Get Codex CLI help

Examples

Code analysis:

Use codex to analyze this authentication logic for security issues

Multi-turn conversations:

Use codex with sessionId "refactor" to analyze this module
Use codex with sessionId "refactor" to implement your suggestions

Passing a sessionId creates the session on first use, so listSessions will show it (for this server instance) and subsequent calls can resume context.

Code review:

Use review with base "main" to check my PR changes
Use review with uncommitted true to review my local changes

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →