Archcore MCP Server
공식로컬 stdio MCP 서버로, AI 코딩 에이전트가 저장소에서 직접 구조화된 아키텍처, 규칙 및 결정을 읽고 유지 관리할 수 있게 해줍니다.
문서
Archcore CLI
당신의 AI 에이전트가 추측을 멈추고 아키텍처를 따르기 시작합니다.
Git은 코드를 배포합니다. CI/CD는 배포를 배포합니다. Archcore는 이해를 배포합니다.
Archcore는 결정, 규칙, 관례를 Git에 저장하므로 AI 에이전트가 이를 자동으로 따릅니다. Claude Code, Cursor, Copilot, Gemini CLI, Codex, OpenCode, Roo Code, Cline 전반에서 작동합니다.
Archcore는 CLI 및 로컬 stdio MCP 서버로 제공되며, 모든 MCP 호환 코딩 에이전트가 표준 도구를 통해 저장소 컨텍스트를 읽고 쓸 수 있습니다. Claude Code / Cursor 플러그인은 더 높은 수준의 워크플로 계층을 추가합니다.
Claude Code 또는 Cursor를 사용 중이신가요? CLI와 Archcore Plugin을 함께 사용하세요. 동일한 엔진에 스킬, 의도 명령, 가드레일이 기본 제공됩니다. CLI만 사용하는 것도 좋습니다. 다른 모든 에이전트에서 작동합니다.
60초 안에
curl -fsSL https://archcore.ai/install.sh | bash
cd your-project && archcore init
그런 다음 AI 에이전트를 열고 다음과 같이 말하세요:
"기본 스토리지로 PostgreSQL을 사용합니다. 이 결정을 기록해 주세요."
완료. 이제 .archcore/에 구조화된 ADR이 있으며, 모든 향후 세션에서 어떤 에이전트든 읽을 수 있습니다.
Windows를 사용 중이신가요? PowerShell을 사용하세요:
irm https://archcore.ai/install.ps1 | iex. WSL의 경우go install, 기타 옵션은 설치 방법 또는 전체 설치 가이드를 참조하세요.
AI에게 다음과 같은 것들을 물어보세요
저장소에 몇 개의 문서가 있으면 에이전트가 이를 사용할 수 있습니다. 시도해 보세요:
"인증 모듈을 건드리기 전에 여기에 적용되는 ADR과 규칙은 무엇인가요?"
에이전트가 한 줄도 편집하기 전에 해당 영역과 관련된 결정과 규칙을 로드합니다.
"새 API 핸들러를 추가하고 이 저장소의 관례를 따르세요."
에이전트가 일치하는 규칙(예: "핸들러는 src/api/handlers/에 위치")을 표시하고 아키텍처가 지정한 위치에 코드를 배치합니다.
"오류 처리 규칙이 무엇인가요?"
에이전트가 코드베이스의 몇 가지 예시를 추측하는 대신 .archcore/에서 바로 error-wrapping.rule.md을 읽습니다.
먼저 이것들을 시도해 보세요
이 프롬프트는 결정, 규칙, 계획, 인시던트와 같은 새로운 컨텍스트를 캡처합니다. 각각은 에이전트(또는 모든 팀원)가 나중에 재사용할 수 있는 구조화된 문서를 생성합니다.
새 저장소인가요? archcore init이 .archcore/을 생성합니다. MCP 서버는 빈 저장소에서도 작동하며 init_project 도구를 노출하므로 에이전트가 부트스트랩할 수 있습니다.
"기본 데이터베이스로 MongoDB 대신 PostgreSQL을 사용하기로 결정했습니다. 이 결정을 기록해 주세요."
컨텍스트, 결정, 고려된 대안, 결과가 포함된 infrastructure/use-postgres.adr.md을 생성합니다.
"팀 관례가 있습니다: 항상 fmt.Errorf와 %w를 사용하여 컨텍스트로 오류를 래핑합니다. 이것을 규칙으로 만드세요."
필수 지침, 근거, 좋은/나쁜 코드 예시가 포함된 backend/error-wrapping.rule.md을 생성합니다.
"지난주에 유휴 연결이 재활용되지 않아 연결 풀 고갈 인시던트가 발생했습니다. 다시 반복하지 않도록 문서화해 주세요."
근본 원인 분석 및 예방 단계가 포함된 incidents/connection-pool-exhaustion.cpat.md을 생성합니다.
"사용자 알림 기능(푸시, 이메일 다이제스트, 인앱 알림)에 대한 PRD가 필요합니다."
목표, 사용자 스토리, 요구 사항, 성공 지표가 포함된 notifications/user-notifications.prd.md를 생성합니다.
"알림 PRD에 대한 구현 계획을 만들고 서로 연결해 주세요."
notifications/notifications-implementation.plan.md을 생성한 다음 implements 관계로 PRD에 연결합니다.
이 중 하나라도 공감된다면, Archcore의 나머지 부분도 마찬가지입니다. 단지 구조화되어 있을 뿐입니다.
설치 후 변경되는 사항
Archcore가 없으면 에이전트는:
- 아키텍처를 무시합니다
- 관례를 위반합니다
- 이미 존재하는 로직을 복제합니다
- 팀이 이미 내린 결정을 다시 논쟁합니다
- 모든 채팅에서 동일한 관례를 반복해야 합니다
- 세션이 끝나는 순간 프로젝트 진실을 잃습니다
Archcore를 사용하면 동일한 요청이 다음과 같은 코드를 생성합니다:
- 아키텍처가 지정한 위치에 배치됩니다
- 이미 Git에 있는 ADR, 사양, 규칙을 존중합니다
- 세션 시작 시 자동으로 로드된 팀 관례를 따릅니다
- 새로운 결정을 마크다운 무덤이 아닌 미래의 가드레일로 반영합니다
AI는 시스템을 추측하지 않고 따라야 합니다.
Archcore를 사용해야 할 때
- 에이전트가 코드를 작성하지만 이 저장소가 예상하는 방식이 아닙니다
CLAUDE.md/.cursorrules/AGENTS.md이 계속 증가하고 표류합니다- 2개 이상의 에이전트 또는 2개 이상의 호스트 도구(Claude Code + Cursor + Copilot)로 작업합니다
- 결정, 규칙, 사양을 채팅 스크롤백이 아닌 Git에 보관하려고 합니다
적합하지 않은 경우 — 채팅 메모리, 프롬프트 라이브러리, 일회성 사양-코드 생성기. Archcore는 방법론 키트가 아닌 코딩 에이전트를 위한 저장소 진실 계층입니다.
왜 단순한 지시 파일이 아닌가요?
CLAUDE.md, AGENTS.md, 저장소 지시 사항은 유용한 시작점이지만 팀에 다음이 필요할 때 무너집니다:
- 하나 이상의 평면 메모리 파일
- 구조화된 문서 유형 — ADR, 규칙, 계획, 인시던트
- 여러 AI 도구에서 재사용 가능한 컨텍스트
- 코드베이스와 함께 성장하는 버전 관리된 프로젝트 지식
- 문서 간의 관계(PRD를 구현하는 계획, ADR을 확장하는 RFC)
- 에이전트가 나중에 선택할 수 있는 인시던트 학습 및 반복 워크플로
지시 파일은 에이전트에게 _원하는 것_을 알려줍니다. Archcore는 에이전트에게 _시스템 작동 방식_을 알려주므로 에이전트가 추측하는 대신 시스템을 따를 수 있습니다.
지원되는 에이전트
Archcore CLI 자체는 로컬 stdio MCP 서버이며, 이는 아래 표의 모든 MCP 호환 에이전트를 위한 공유 통합 표면입니다. 후크는 에이전트가 지원하는 경우 사전 예방적 세션 시작 컨텍스트를 추가합니다.
| 에이전트 | 후크 | MCP |
|---|---|---|
| Claude Code | 예 | 예 |
| Cursor | 예 | 예 |
| Gemini CLI | 예 | 예 |
| GitHub Copilot | 예 | 예 |
| OpenCode | — | 예 |
| Codex CLI | — | 예 |
| Roo Code | — | 예 |
| Cline | — | 수동 |
작동 방식
-
저장소 초기화
archcore init이.archcore/을 생성하고 지원되는 에이전트에 대한 통합을 설치합니다. -
지속적인 컨텍스트 캡처 아키텍처 결정, 규칙, 계획, 제품 문서, 인시던트 학습을 구조화된 마크다운 파일로 저장합니다.
-
에이전트가 재사용하도록 허용 후크와 MCP를 통해 코딩 에이전트가 기존 컨텍스트를 읽고 실제 작업 중에 문서를 생성하거나 업데이트할 수 있습니다.
-
Git에 보관 코드처럼 컨텍스트 변경 사항을 검토하고, 시간이 지남에 따라 발전시키며, 도구 간에 이식성을 유지합니다.
멘탈 모델
Archcore CLI는 컨텍스트 컴파일러입니다. 분산된 문서를 구조화된 기계 판독 가능 컨텍스트로 변환합니다. MCP와 후크는 런타임입니다. 에이전트가 실제 작업 중에 해당 컨텍스트를 소비하는 데 사용하는 표면입니다. Claude Code 및 Cursor용 Archcore Plugin은 그 위에 구축된 더 높은 수준의 런타임입니다.
implicit repo knowledge → structured context → AI-readable system
.archcore/에 있는 것
.archcore/
├── settings.json
├── .sync-state.json
├── auth/
│ ├── jwt-strategy.adr.md
│ └── auth-redesign.prd.md
├── backend/
│ └── error-wrapping.rule.md
├── incidents/
│ └── connection-pool-exhaustion.cpat.md
└── notifications/
└── notifications-implementation.plan.md
구조는 자유 형식입니다. 도메인, 기능, 팀 또는 저장소에 맞는 방식으로 문서를 구성하세요. 카테고리는 가상이며 파일 이름의 문서 유형(slug.type.md)에서 추론됩니다.
.archcore/을 다음 용도로 사용하세요:
- 아키텍처 결정
- 코딩 규칙 및 관례
- 구현 계획
- 제품 요구 사항
- 인시던트 및 사후 분석
- 재사용 가능한 워크플로 지식
작동 예제는 Archcore CLI 저장소 자체를 참조하세요: 이 저장소의 .archcore/
기본 제공되는 것
- 비전, 지식, 경험 전반에 걸친 18가지 문서 유형
- 4가지 관계 유형 —
related,implements,extends,depends_on - 10가지 MCP 도구 —
list_documents,get_document,create_document,update_document,remove_document,search_documents,init_project및 관계 관리(add_relation,remove_relation,list_relations) - 5가지 다중 문서 프롬프트 — MCP 호환 에이전트에서 슬래시 명령으로 호출 가능한 추적 캐스케이드
- 4개 에이전트(Claude Code, Cursor, Gemini CLI, GitHub Copilot)용 후크 통합 및 8개용 MCP 통합
문서 유형
Archcore는 컨텍스트를 비전, 지식, 경험의 3가지 지식 계층으로 구성합니다.
비전
| 유형 | 전체 이름 | 설명 |
|---|---|---|
prd | 제품 요구 사항 문서 | 목표, 사용자 스토리, 수락 기준, 성공 지표 |
idea | 아이디어 | 향후 탐색을 위한 제품 또는 기술 아이디어의 가벼운 캡처 |
plan | 계획 | 수락 기준 및 종속성이 있는 단계별 작업 목록 |
Archcore는 구조화된 발견 또는 공식적인 분해가 필요한 팀을 위해 두 가지 추가 요구 사항 트랙도 지원합니다:
소스 트랙 (MRD → BRD → URD) — 요구 사항의 _출처_를 캡처합니다:
| 유형 | 전체 이름 | 설명 |
|---|---|---|
mrd | 시장 요구 사항 문서 | 시장 환경, TAM/SAM/SOM, 경쟁 분석, 시장 요구 사항 |
brd | 비즈니스 요구 사항 문서 | 비즈니스 목표, 이해 관계자, ROI, 비즈니스 규칙 |
urd | 사용자 요구 사항 문서 | 사용자 페르소나, 여정, 사용성 요구 사항, 수락 기준 |
ISO/IEC/IEEE 29148:2018 트랙 (BRS → StRS → SyRS → SRS) — 요구 사항이 _분해되는 방식_을 캡처합니다:
| 유형 | 전체 이름 | 설명 |
|---|---|---|
brs | 비즈니스 요구 사항 명세 | 미션, 목표, 목적, 비즈니스 운영 개념 |
strs | 이해 관계자 요구 사항 명세 | 이해 관계자 요구, 운영 개념, 사용자 요구 사항 |
syrs | 시스템 요구 사항 명세 | 시스템 기능, 인터페이스, 성능, 설계 제약 조건 |
srs | 소프트웨어 요구 사항 명세 | 소프트웨어 기능, 외부 인터페이스, 상세 동작 사양 |
대부분의 프로젝트에는 PRD를 사용하세요. 구조화된 요구 사항 발견이 필요할 때 소스 트랙을 추가하세요. 규제 대상이거나 복잡한 다중 팀 시스템에 공식적인 추적성이 필요할 때 ISO 29148을 추가하세요. 자유롭게 혼합하세요. 일부 기능은 PRD를 사용하고 다른 기능은 전체 캐스케이드를 사용할 수 있습니다.
지식
| 유형 | 전체 이름 | 설명 |
|---|---|---|
adr | 아키텍처 결정 기록 | 컨텍스트, 대안, 결과와 함께 최종 기술 결정을 캡처합니다 |
rfc | 의견 요청 | 팀 검토 및 피드백을 위해 공개된 중요한 변경 사항을 제안합니다 |
rule | 규칙 | 필수 지침 및 예시가 포함된 코딩 또는 프로세스 표준 |
guide | 가이드 | 특정 작업 완료를 위한 단계별 지침 |
doc | 문서 | 참조 문서, 레지스트리, 설명 자료 |
spec | 사양 | 시스템, 구성 요소, 인터페이스 또는 프로토콜에 대한 표준 규범 계약 |
경험
| 유형 | 전체 이름 | 설명 |
|---|---|---|
task-type | 작업 유형 | 반복 작업을 위한 재사용 가능한 체크리스트 및 워크플로 |
cpat | 코드 변경 패턴 | 버그 또는 인시던트의 근본 원인 분석 및 예방 단계 |
각 문서는 YAML 프론트매터가 포함된 Markdown 파일입니다:
---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---
## Context
...
유효한 상태: draft, accepted, rejected. 태그는 선택 사항이며 자유 형식입니다 — 교차 주제를 표시하는 데 사용하세요 (security, golang, frontend).
문서 관계
문서는 다른 문서와 방향성 있는 관계로 연결될 수 있습니다:
- related — 일반적인 연관
- implements — 소스가 대상이 지정하는 것을 구현
- extends — 소스가 대상을 기반으로 구축
- depends_on — 소스가 진행하기 위해 대상이 필요
관계는 .sync-state.json에 저장되며 MCP 도구를 통해 AI 에이전트가 자동으로 관리합니다.
AI 에이전트 통합
Archcore는 세 가지 방식으로 AI 코딩 에이전트와 통합됩니다:
- 훅은 세션 시작 시 컨텍스트를 주입하여 에이전트가 첫 메시지부터
.archcore/문서를 인지하도록 합니다. - MCP 도구는 에이전트가 실시간으로 문서를 나열, 검색, 읽기, 생성, 업데이트 및 연결할 수 있는 기능을 제공합니다. MCP 서버는 빈 리포지토리에서도 작동하며
init_project도구를 노출하므로 에이전트가.archcore/자체를 부트스트랩할 수 있습니다. - MCP 프롬프트는 에이전트에서 슬래시 명령으로 트리거하는 즉시 사용 가능한 다중 문서 워크플로입니다.
프롬프트
프롬프트는 한 번의 호출로 전체 문서 캐스케이드를 조정합니다 — 에이전트가 트랙의 모든 문서를 생성하고 연결합니다. 대부분의 MCP 호환 에이전트는 이를 슬래시 명령으로 표시합니다 (예: /architecture_track). 정확한 접두사는 클라이언트에 따라 다릅니다.
| 프롬프트 | 수행 작업 |
|---|---|
product_track | 아이디어 → PRD → 계획 (경량 기능 흐름) |
architecture_track | ADR → 사양 → 계획 (기술 설계 + 구현) |
standard_track | ADR → 규칙 → 가이드 (팀 표준 코드화) |
sources_track | MRD → BRD → URD (시장 / 비즈니스 / 사용자 발견) |
iso_track | BRS → StRS → SyRS → SRS (공식 ISO 29148 캐스케이드) |
예시. 에이전트에서 /product_track feature="user notifications"을 실행하세요. 에이전트가 아이디어 초안을 작성하고, PRD를 도출하며, 구현 계획을 수립하고 자동으로 연결합니다.
로컬 MCP 서버
Archcore는 호스팅 서비스가 필요하지 않습니다. CLI는 로컬 stdio MCP 서버를 실행합니다:
archcore mcp
기본적으로 archcore mcp는 현재 디렉터리의 문서를 제공합니다. --project /path/to/repo을 전달하거나 ARCHCORE_PROJECT_ROOT를 설정하여 다른 위치를 가리키도록 할 수 있습니다 — 서버가 작업 공간이 아닌 디렉터리에서 시작될 때 유용합니다 (예: 편집기 통합으로 인해).
Claude Code에 연결:
claude mcp add --transport stdio archcore -- archcore mcp
또는 지원되는 에이전트에 자동으로 설치:
archcore mcp install --agent cursor
통합 설치
# Auto-detect agents in your project and install everything
archcore hooks install
# Or target a specific agent
archcore mcp install --agent opencode
archcore hooks install --agent cursor
명령
| 명령 | 설명 |
|---|---|
archcore init | .archcore/ 디렉터리를 대화형으로 초기화 |
archcore doctor | archcore 설정을 확인하고 문제 해결 |
archcore status | .archcore/ 구조 및 문서 상태 확인 |
archcore config | 설정 보기 또는 수정 |
archcore hooks install | 감지된 AI 에이전트용 훅 설치 |
archcore update | Archcore를 최신 버전으로 업데이트 |
archcore mcp | MCP stdio 서버 실행 |
archcore mcp install | 감지된 에이전트용 MCP 구성 설치 |
업데이트
archcore update
이 명령은 GitHub 릴리스에서 최신 버전을 확인하고, 다운로드한 후 SHA-256 체크섬을 검증하며, 현재 바이너리를 원자적으로 교체합니다.
설치 방법
macOS / Linux
curl -fsSL https://archcore.ai/install.sh | bash
Windows
irm https://archcore.ai/install.ps1 | iex
%LOCALAPPDATA%\Programs\archcore 아래에 archcore.exe를 설치하고 사용자 PATH에 추가합니다. 설치 후 새 PowerShell 창을 열어 PATH 변경 사항을 적용하세요.
Windows (WSL)
WSL을 설치한 후 내부에서 실행:
curl -fsSL https://archcore.ai/install.sh | bash
Go 설치
go install github.com/archcore-ai/cli@latest
소스에서 설치
git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .
지원 플랫폼: macOS, Linux, Windows — amd64 및 arm64.
환경 변수(ARCHCORE_VERSION, ARCHCORE_INSTALL_DIR, GITHUB_TOKEN) 및 PATH 문제 해결에 대해서는 docs.archcore.ai의 전체 설치 가이드를 참조하세요.
구성
설정은 .archcore/settings.json에 저장되며 archcore init 중에 생성됩니다.
| 필드 | 설명 | 값 |
|---|---|---|
sync | 동기화 모드. 클라우드 및 온프레미스는 곧 제공됩니다. | none (로컬 전용), cloud, on-prem |
language | 문서 언어. 에이전트가 올바른 언어로 문서를 생성하도록 돕습니다. | 문자열, 기본값 en |
archcore config # show all settings
archcore config get <key> # get a specific value
archcore config set <key> <value> # set a value
개발
사전 요구 사항
- Go 1.24+
빌드 및 테스트
# Build
go build -o archcore .
# Run all tests
go test ./...
# Run a specific package
go test ./cmd/
# Run a single test
go test ./cmd/ -run TestConfigCmd
프로젝트 구조
├── cmd/ # Cobra commands (init, doctor, config, status, hooks, mcp, ...)
├── internal/
│ ├── agents/ # Supported AI agents with hooks/MCP capabilities
│ ├── api/ # HTTP client for archcore server
│ ├── config/ # Settings management and directory init
│ ├── display/ # Terminal output formatting (lipgloss)
│ ├── update/ # Self-update logic (version check, download, verify, replace)
│ ├── mcp/ # MCP stdio server, tools, and prompts
│ └── sync/ # Sync logic
├── templates/ # Document type templates
├── install.sh # Install script
└── .goreleaser.yaml # Release configuration
Archcore는 BMAD / Spec Kit / Memory Bank와 유사한가요?
아니요 — 이들은 서로 다른 문제를 해결합니다. 간략 비교:
| 도구 | 카테고리 | 정의 | Archcore의 차이점 |
|---|---|---|---|
| BMAD | 방법론 | 에이전트 SDLC 방법론 — 12개 이상의 역할, 34개 이상의 워크플로 | Archcore는 _산출물_을 저장합니다. BMAD는 _프로세스_를 규정합니다. |
| Spec Kit | 방법론 | 사양 중심 워크플로: specify → plan → tasks → implement, 일회성 | Spec Kit은 일회성 핸드오프입니다. Archcore는 코드베이스와 함께 진화하는 살아있는 그래프를 유지 관리합니다. |
| Agent OS | 방법론 | 코드베이스 표준 추출 + 사양 중심 개발 | 가장 유사한 포지셔닝. Archcore는 유형화된 문서, 검증된 관계 및 선택적 ISO 캐스케이드를 추가합니다. |
| claude-mem / Mem0 | 메모리 | 세션 메모리 자동 캡처, 에이전트 간 회상 | 메모리 도구는 _수행한 작업_을 기억합니다. Archcore는 _시스템 구축 방식과 결정된 사항_을 저장합니다. |
| Cline Memory Bank | 문서 | 고정 스키마 마크다운 파일 (projectbrief, activeContext, systemPatterns…) | 동일한 정신, 더 적은 형식. Archcore는 유형화된 관계, MCP 검증 및 다단계 캐스케이드를 추가합니다. |
| CLAUDE.md / .cursorrules | 지침 | 에이전트가 세션 시작 시 읽는 단일 플랫 파일 | Archcore는 증가하는 지침 파일을 유형화되고, 관련되며, 쿼리 가능한 문서로 대체합니다. |
의견이 반영된 개발 흐름을 원한다면 방법론 도구를 선택하세요. 세션 연속성을 원한다면 메모리 도구를 선택하세요. 모든 요청 시 코딩 에이전트가 존중하는 이 리포지토리의 결정, 규칙 및 아키텍처인 유형화되고 쿼리 가능한 _프로젝트 진실_을 원한다면 Archcore를 선택하세요.
링크 및 라이선스
- 문서: docs.archcore.ai
- 웹사이트: archcore.ai
- 플러그인 (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
- 이슈: github.com/archcore-ai/cli/issues
- 라이선스: Apache 2.0