CodeAtlas MCP Server
CodeAtlas는 코드베이스 분석, 의존성 및 호출 그래프, 검색, 프로젝트 컨텍스트를 위한 로컬 MCP(Multi-Client Protocol) 서버입니다. 실행되는 머신의 프로젝트 파일을 읽고, 기본적으로 프로세스 메모리에 분석 데이터를 유지하며, 설정에 따라 분석 데이터와 메모리를 CodeAtlas Cloud로 선택적으로 동기화할 수 있습니다.
CI
Node.js Version
License: MIT
GitHub Release
기능 설명 (What it does)
- 지원되는 소스 파일을 구문 분석하고 코드 구조 및 관계 그래프를 구축합니다.
- 프로젝트 분석, 코드 검색, 의존성 및 호출 관계, 영향도 분석(impact analysis), 보안 스캐닝을 위한 MCP 도구를 제공합니다.
- 분석된 프로젝트 데이터를 서버 프로세스의 메모리에 보관합니다. 기본적으로 분석 데이터는 로컬 분석 파일로 저장되지 않습니다.
- 꿈의 기억(dream memories)이나 Genome 검색과 같은 선택적 CodeAtlas Cloud 기능을 제공합니다. 클라우드 도구 사용을 위해서는
CODEATLAS_API_URL 및 API 키가 필요합니다.
소스 코드는 분석을 위해 로컬에서 읽힙니다. 클라우드 동기화가 구성되면, 분석 결과와 호출하는 모든 클라우드 도구는 설정된 CodeAtlas API로 전송됩니다. export_team_artifact 도구를 사용하면 공유 가능한 분석 아티팩트를 .codeatlas/에 명시적으로 작성할 수 있습니다. 로컬 및 클라우드 데이터 흐름은 런타임 아키텍처를 검토하십시오.
설치 및 실행 (Install and run)
이 패키지는 Node.js 20 이상을 요구합니다. 여러 개의 실행 가능한 이름을 게시하므로, npx 사용 시 명시적으로 하나를 선택해야 합니다:
npx --yes --package=codeatlas-mcp-server codeatlas-mcp
체크아웃에서 실행하려면:
npm ci
pm run build
pm start
MCP 서버는 stdio transport를 사용합니다. Claude Desktop이나 Zed와 같은 MCP 클라이언트에서 이를 구성하십시오. 이 패키지는 HTTP 또는 SSE MCP 엔드포인트를 노출하지 않습니다.
패키지 루트는 ESM으로 내보내지며 동일한 CLI/서버 엔트리 포인트를 가리킵니다. 이를 가져오면 해당 엔트리가 실행됩니다. 일반적인 MCP 시작을 위해서는 실행 파일을 사용하세요.
MCP 클라이언트 구성
Claude Desktop 예시:
{
"mcpServers": {
"codeatlas": {
...
클라이언트 구성에 대해서는 Zed Integration를 참조하세요. 이 패키지는 또한 codeatlas, codeatlas-mcp, codeatlas-enterprise, 그리고 codeatlas-setup-claude 실행 파일을 제공합니다.
클라우드 구성
로컬 코드 분석은 클라우드 자격 증명 없이 실행할 수 있습니다. 클라우드 기능에는 설정된 API URL과 키가 모두 필요합니다. API URL은 암묵적인 기본값이 없으므로 명시적으로 설정해야 합니다:
export CODEATLAS_API_URL="https://api.codeatlas.ai"
export CODEATLAS_API_KEY="your_api_key_here"
npx --yes --package=codeatlas-mcp-server codeatlas-mcp
일반적인 MCP 시작을 위해서는 이 값들을 작업 디렉터리 또는 ~/.codeatlas/.env에 있는 .env 파일에 배치할 수도 있습니다. 기존 프로세스 변수가 우선합니다. 일회성 CLI 명령어는 dotenv 로딩 전에 실행되므로, 시작 환경에서 설정을 내보내야 합니다. 서버는 지원되는 MCP 클라이언트 구성 파일에서 누락된 키를 해결할 수 있으며, 일부 설정 도구는 구성을 로컬에 유지합니다. 로컬 구성 파일은 민감하게 취급하세요.
| 변수 | 동작 |
|---|
CODEATLAS_API_URL | CodeAtlas API 기본 URL; 서버에서 암묵적인 기본값 없음. 인식되는 호스트로는 api.codeatlas.ai, codeatlas.ai의 서브도메인 및 codeatlas-local.dev, opencode.ai, 그리고 루프백 호스트가 포함됩니다. |
| ... | |
| See AI 요청 내용 및 목적지 규칙에 대해서는 scanner guide를 참조하세요. | |
MCP 도구
Tools는 프로젝트 분석 및 구조, 엔티티 및 코드 검색, 의존성 및 호출 그래프, 기능 추적(feature tracing), 영향도 분석(impact analysis), 취약점 스캔(vulnerability scanning), 프로젝트 컨텍스트, 아키텍처 결정 등을 다루며, 선택적으로 Cloud 메모리 및 Genome 기능을 제공합니다. 사용 가능한 도구들은 런타임 시 서버에 등록되며, 현재 세트 목록은 MCP 클라이언트 도구 목록을 참고하십시오. 최신 도구 이름과 인자 예시는 API Examples를 참조하십시오.
문서화 (Documentation)
| 가이드 | 설명 |
|---|
| 런타임 아키텍처 | 시작(Startup), 로컬 분석, 영속성(persistence), 그리고 선택적 Cloud 경로. |
| ... | |
기여 (Contributing)
가이드라인은 CONTRIBUTING.md를 참조하십시오. 패키지는 Node.js 20 이상을 선언하며, CI는 Node.js 22로도 테스트합니다.
라이선스 (License)
MIT © Giau Phan
