Archcore MCP Server

resmi

Server MCP stdio lokal yang memungkinkan agen pengkodean AI membaca dan memelihara arsitektur, aturan, serta keputusan terstruktur langsung dari repositori Anda.

GitHub

Dokumentasi

Archcore CLI

Agen AI Anda berhenti menebak dan mulai mengikuti arsitektur Anda.

Git mengirimkan kode Anda. CI/CD mengirimkan pengiriman Anda. Archcore mengirimkan pemahaman Anda.

Archcore menyimpan keputusan, aturan, dan konvensi Anda di Git — sehingga agen AI Anda mengikutinya secara otomatis. Bekerja di Claude Code, Cursor, Copilot, Gemini CLI, Codex, OpenCode, Roo Code, dan Cline.

Archcore hadir sebagai CLI dan server MCP stdio lokal — agen pengkodean apa pun yang kompatibel dengan MCP dapat membaca dan menulis konteks repo Anda melalui alat standar, sementara plugin Claude Code / Cursor menambahkan lapisan alur kerja tingkat lebih tinggi.

Menggunakan Claude Code atau Cursor? Pasangkan CLI dengan Plugin Archcore — mesin yang sama, plus keterampilan, perintah intent, dan pagar pembatas siap pakai. Tetap menggunakan CLI juga bagus — ia bekerja di setiap agen lainnya.

Dalam 60 detik

curl -fsSL https://archcore.ai/install.sh | bash
cd your-project && archcore init

Kemudian buka agen AI Anda dan katakan:

"Kami menggunakan PostgreSQL untuk penyimpanan utama. Catat keputusan ini."

Selesai. Sekarang ada ADR terstruktur di .archcore/ yang dapat dibaca oleh setiap sesi mendatang — di agen mana pun.

Di Windows? Gunakan PowerShell: irm https://archcore.ai/install.ps1 | iex. Untuk WSL, go install, dan opsi lainnya, lihat Metode instalasi atau panduan instalasi lengkap.

Tanyakan hal-hal seperti ini ke AI Anda

Setelah repo Anda memiliki beberapa dokumen, agen Anda dapat menggunakannya. Coba:

"Sebelum saya menyentuh modul auth, ADR dan aturan apa yang berlaku di sini?"

Agen memuat keputusan dan aturan relevan yang terkait dengan area tersebut sebelum mengedit satu baris pun.

"Tambahkan handler API baru dan ikuti konvensi repo ini."

Agen menampilkan aturan yang cocok (mis. "handler berada di src/api/handlers/") dan menempatkan kode sesuai dengan yang ditentukan arsitektur Anda.

"Apa aturan penanganan error kita?"

Agen membaca error-wrapping.rule.md langsung dari .archcore/ alih-alih menebak dari beberapa contoh di basis kode.

Coba ini dulu

Prompt ini menangkap konteks baru — keputusan, aturan, rencana, insiden. Masing-masing membuat dokumen terstruktur yang dapat digunakan kembali oleh agen (atau rekan tim mana pun) nanti.

Repo baru? archcore init membuat .archcore/. Server MCP juga berfungsi di repo kosong dan mengekspos alat init_project, sehingga agen dapat melakukan bootstrap untuk Anda.

"Kami memutuskan untuk menggunakan PostgreSQL alih-alih MongoDB untuk database utama kami. Catat keputusan ini."

Membuat infrastructure/use-postgres.adr.md dengan konteks, keputusan, alternatif yang dipertimbangkan, dan konsekuensi.

"Kami memiliki konvensi tim: selalu bungkus error dengan konteks menggunakan fmt.Errorf dan %w. Jadikan ini aturan."

Membuat backend/error-wrapping.rule.md dengan panduan imperatif, alasan, dan contoh kode baik/buruk.

"Minggu lalu kami mengalami insiden kehabisan connection pool karena koneksi idle tidak didaur ulang. Dokumentasikan ini agar tidak terulang."

Membuat incidents/connection-pool-exhaustion.cpat.md dengan analisis akar penyebab dan langkah pencegahan.

"Saya butuh PRD untuk fitur notifikasi pengguna — push, ringkasan email, dan peringatan dalam aplikasi."

Membuat notifications/user-notifications.prd.md dengan tujuan, cerita pengguna, persyaratan, dan metrik keberhasilan.

"Buat rencana implementasi untuk PRD notifikasi dan tautkan keduanya."

Membuat notifications/notifications-implementation.plan.md, lalu menautkannya ke PRD dengan relasi implements.

Jika salah satu dari ini sesuai, Archcore selanjutnya kurang lebih sama — hanya terstruktur.

Apa yang berubah setelah instalasi

Tanpa Archcore, agen:

mengabaikan arsitektur Anda
melanggar konvensi Anda
menduplikasi logika yang sudah ada
memperdebatkan kembali keputusan yang sudah dibuat tim Anda
membutuhkan konvensi yang sama diulangi di setiap obrolan
kehilangan kebenaran proyek begitu sesi berakhir

Dengan Archcore, permintaan yang sama menghasilkan kode yang:

ditempatkan sesuai dengan yang ditentukan arsitektur Anda
menghormati ADR, spesifikasi, dan aturan yang sudah ada di Git
mengikuti konvensi tim yang dimuat otomatis saat sesi dimulai
mencerminkan keputusan baru sebagai pagar pembatas masa depan, bukan kuburan markdown

AI seharusnya mengikuti sistem Anda, bukan menebaknya.

Gunakan Archcore ketika

Agen Anda menulis kode, tetapi tidak sesuai dengan yang diharapkan repo ini
CLAUDE.md / .cursorrules / AGENTS.md Anda terus bertambah dan melenceng
Anda bekerja dengan 2+ agen atau 2+ alat host (Claude Code + Cursor + Copilot)
Anda ingin keputusan, aturan, dan spesifikasi di Git — bukan di riwayat obrolan

Bukan untuk — memori obrolan, pustaka prompt, atau generator spesifikasi-ke-kode sekali pakai. Archcore adalah lapisan kebenaran repo untuk agen pengkodean, bukan kit metodologi.

Mengapa tidak hanya file instruksi?

CLAUDE.md, AGENTS.md, dan instruksi repositori adalah titik awal yang berguna, tetapi mereka gagal ketika tim Anda membutuhkan:

lebih dari satu file memori datar
tipe dokumen terstruktur — ADR, aturan, rencana, insiden
konteks yang dapat digunakan kembali di berbagai alat AI
pengetahuan proyek berversi yang tumbuh bersama basis kode
relasi antar dokumen (rencana yang mengimplementasikan PRD, RFC yang memperluas ADR)
pembelajaran insiden dan alur kerja berulang yang dapat diambil agen nanti

File instruksi memberi tahu agen apa yang Anda inginkan. Archcore memberi tahu agen bagaimana sistem Anda bekerja — sehingga agen dapat mengikuti sistem Anda alih-alih menebaknya.

Agen yang didukung

Archcore CLI sendiri adalah server MCP stdio lokal — itu adalah permukaan integrasi bersama untuk setiap agen yang kompatibel dengan MCP di tabel di bawah ini. Hook menambahkan konteks awal sesi proaktif di mana agen mendukungnya.

Agen	Hook	MCP
Claude Code	ya	ya
Cursor	ya	ya
Gemini CLI	ya	ya
GitHub Copilot	ya	ya
OpenCode	—	ya
Codex CLI	—	ya
Roo Code	—	ya
Cline	—	manual

Cara kerjanya

Inisialisasi repo Anda archcore init membuat .archcore/ dan menginstal integrasi untuk agen yang didukung.
Tangkap konteks tahan lama Simpan keputusan arsitektur, aturan, rencana, dokumen produk, dan pembelajaran insiden sebagai file Markdown terstruktur.
Biarkan agen menggunakannya kembali Hook dan MCP memungkinkan agen pengkodean Anda membaca konteks yang ada dan membuat atau memperbarui dokumen selama pekerjaan nyata.
Simpan di Git Tinjau perubahan konteks seperti kode, kembangkan seiring waktu, dan jaga agar tetap portabel di berbagai alat.

Model mental

Archcore CLI adalah kompiler konteks — ia mengubah dokumen yang tersebar menjadi konteks terstruktur yang dapat dibaca mesin. MCP dan hook adalah runtime — permukaan yang digunakan agen untuk mengonsumsi konteks tersebut selama pekerjaan nyata. Plugin Archcore untuk Claude Code dan Cursor adalah runtime tingkat lebih tinggi yang dibangun di atasnya.

implicit repo knowledge  →  structured context  →  AI-readable system

Apa yang ada di `.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

Strukturnya bebas bentuk — atur dokumen berdasarkan domain, fitur, tim, atau apa pun yang sesuai dengan repo Anda. Kategori bersifat virtual dan disimpulkan dari tipe dokumen di nama file (slug.type.md).

Gunakan .archcore/ untuk:

keputusan arsitektur
aturan dan konvensi pengkodean
rencana implementasi
persyaratan produk
insiden dan postmortem
pengetahuan alur kerja yang dapat digunakan kembali

Lihat repositori Archcore CLI itu sendiri untuk contoh kerja: .archcore/ di repo ini

Apa yang disertakan

18 tipe dokumen di seluruh visi, pengetahuan, dan pengalaman
4 tipe relasi — related, implements, extends, depends_on
10 alat MCP — list_documents, get_document, create_document, update_document, remove_document, search_documents, init_project, plus manajemen relasi (add_relation, remove_relation, list_relations)
5 prompt multi-dokumen — lacak kaskade yang dapat dipanggil sebagai perintah garis miring dari agen yang kompatibel dengan MCP
Integrasi hook untuk 4 agen (Claude Code, Cursor, Gemini CLI, GitHub Copilot) dan integrasi MCP untuk 8

Tipe dokumen

Archcore mengatur konteks ke dalam 3 lapisan pengetahuan: Visi, Pengetahuan, dan Pengalaman.

Visi

Tipe	Nama Lengkap	Deskripsi
`prd`	Dokumen Persyaratan Produk	Tujuan, cerita pengguna, kriteria penerimaan, dan metrik keberhasilan
`idea`	Ide	Penangkapan ringan ide produk atau teknis untuk eksplorasi di masa depan
`plan`	Rencana	Daftar tugas bertahap dengan kriteria penerimaan dan dependensi

Archcore juga mendukung dua jalur persyaratan tambahan untuk tim yang membutuhkan penemuan terstruktur atau dekomposisi formal:

Jalur sumber (MRD → BRD → URD) — menangkap dari mana persyaratan berasal:

Tipe	Nama Lengkap	Deskripsi
`mrd`	Dokumen Persyaratan Pasar	Lanskap pasar, TAM/SAM/SOM, analisis kompetitif, dan kebutuhan pasar
`brd`	Dokumen Persyaratan Bisnis	Tujuan bisnis, pemangku kepentingan, ROI, dan aturan bisnis
`urd`	Dokumen Persyaratan Pengguna	Persona pengguna, perjalanan, persyaratan kegunaan, dan kriteria penerimaan

Jalur ISO/IEC/IEEE 29148:2018 (BRS → StRS → SyRS → SRS) — menangkap bagaimana persyaratan terdekomposisi:

Tipe	Nama Lengkap	Deskripsi
`brs`	Spesifikasi Persyaratan Bisnis	Misi, tujuan, sasaran, dan konsep operasional bisnis
`strs`	Spesifikasi Persyaratan Pemangku Kepentingan	Kebutuhan pemangku kepentingan, konsep operasional, dan persyaratan pengguna
`syrs`	Spesifikasi Persyaratan Sistem	Fungsi sistem, antarmuka, kinerja, dan batasan desain
`srs`	Spesifikasi Persyaratan Perangkat Lunak	Fungsi perangkat lunak, antarmuka eksternal, dan spesifikasi perilaku terperinci

Gunakan PRD untuk sebagian besar proyek. Tambahkan jalur sumber ketika Anda membutuhkan penemuan persyaratan terstruktur. Tambahkan ISO 29148 ketika Anda membutuhkan ketertelusuran formal untuk sistem yang diatur atau multi-tim yang kompleks. Campurkan secara bebas — beberapa fitur dapat menggunakan PRD sementara yang lain menggunakan kaskade penuh.

Pengetahuan

Tipe	Nama Lengkap	Deskripsi
`adr`	Catatan Keputusan Arsitektur	Menangkap keputusan teknis yang difinalisasi dengan konteks, alternatif, dan konsekuensi
`rfc`	Permintaan Komentar	Mengusulkan perubahan signifikan yang terbuka untuk tinjauan dan umpan balik tim
`rule`	Aturan	Standar pengkodean atau proses dengan panduan imperatif dan contoh
`guide`	Panduan	Instruksi langkah demi langkah untuk menyelesaikan tugas tertentu
`doc`	Dokumen	Dokumentasi referensi, registri, dan materi deskriptif
`spec`	Spesifikasi	Kontrak normatif kanonis untuk sistem, komponen, antarmuka, atau protokol

Pengalaman

Tipe	Nama Lengkap	Deskripsi
`task-type`	Tipe Tugas	Daftar periksa dan alur kerja yang dapat digunakan kembali untuk tugas berulang
`cpat`	Pola Perubahan Kode	Analisis akar penyebab bug atau insiden beserta langkah pencegahannya

Setiap dokumen adalah berkas Markdown dengan frontmatter YAML:

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

Status yang valid: draft, accepted, dan rejected. Tag bersifat opsional dan bebas — gunakan untuk menandai topik lintas sektoral (security, golang, frontend).

Relasi dokumen

Dokumen dapat ditautkan dengan relasi terarah ke dokumen lain:

related — asosiasi umum
implements — sumber mengimplementasikan apa yang ditentukan target
extends — sumber membangun di atas target
depends_on — sumber memerlukan target untuk melanjutkan

Relasi disimpan di .sync-state.json dan dikelola secara otomatis oleh agen AI melalui alat MCP.

Integrasi agen AI

Archcore terintegrasi dengan agen pengkodean AI dalam tiga cara:

Hooks menyuntikkan konteks saat sesi dimulai, sehingga agen mengetahui dokumen .archcore/ Anda sejak pesan pertama.
Alat MCP memberi agen kemampuan untuk mendaftar, mencari, membaca, membuat, memperbarui, dan menautkan dokumen secara real-time. Server MCP juga berfungsi di repositori kosong dan menyediakan alat init_project, sehingga agen dapat melakukan bootstrap .archcore/ sendiri.
Prompt MCP adalah alur kerja multi-dokumen siap pakai yang Anda picu dari agen sebagai perintah garis miring.

Prompt

Prompt mengorkestrasi kaskade dokumen penuh dalam satu panggilan — agen membuat dan menautkan setiap dokumen di jalur untuk Anda. Sebagian besar agen yang kompatibel dengan MCP menampilkannya sebagai perintah garis miring (mis. /architecture_track); prefiks pastinya bergantung pada klien.

Prompt	Fungsinya
`product_track`	ide → PRD → rencana (alur fitur ringan)
`architecture_track`	ADR → spesifikasi → rencana (desain teknis + implementasi)
`standard_track`	ADR → aturan → panduan (mengkodifikasi standar tim)
`sources_track`	MRD → BRD → URD (penemuan pasar / bisnis / pengguna)
`iso_track`	BRS → StRS → SyRS → SRS (kaskade formal ISO 29148)

Contoh. Di agen Anda, jalankan /product_track feature="user notifications". Agen akan menyusun ide, menurunkan PRD, membangun rencana implementasi, dan menautkannya secara otomatis.

Server MCP lokal

Archcore tidak memerlukan layanan yang dihosting. CLI menjalankan server MCP stdio lokal:

archcore mcp

Secara default archcore mcp melayani dokumen dari direktori saat ini. Berikan --project /path/to/repo (atau atur ARCHCORE_PROJECT_ROOT) untuk mengarahkannya ke tempat lain — berguna ketika server diluncurkan dari direktori yang bukan ruang kerja Anda (misalnya, oleh integrasi editor).

Hubungkan ke Claude Code:

claude mcp add --transport stdio archcore -- archcore mcp

Atau instal secara otomatis untuk agen yang didukung:

archcore mcp install --agent cursor

Instal integrasi

# 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

Perintah

Perintah	Deskripsi
`archcore init`	Inisialisasi direktori `.archcore/` secara interaktif
`archcore doctor`	Periksa pengaturan archcore Anda dan perbaiki masalah
`archcore status`	Periksa struktur .archcore/ dan kesehatan dokumen
`archcore config`	Lihat atau ubah pengaturan
`archcore hooks install`	Instal hooks untuk agen AI yang terdeteksi
`archcore update`	Perbarui Archcore ke versi terbaru
`archcore mcp`	Jalankan server MCP stdio
`archcore mcp install`	Instal konfigurasi MCP untuk agen yang terdeteksi

Perbarui

archcore update

Perintah ini memeriksa Rilis GitHub untuk versi yang lebih baru, mengunduhnya, memverifikasi checksum SHA-256, dan mengganti biner saat ini secara atomik.

Metode instalasi

macOS / Linux

curl -fsSL https://archcore.ai/install.sh | bash

Windows

irm https://archcore.ai/install.ps1 | iex

Menginstal archcore.exe di bawah %LOCALAPPDATA%\Programs\archcore dan menambahkannya ke PATH pengguna Anda. Buka jendela PowerShell baru setelah instalasi agar perubahan PATH diterapkan.

Windows (WSL)

Instal WSL, lalu jalankan di dalamnya:

curl -fsSL https://archcore.ai/install.sh | bash

Instalasi Go

go install github.com/archcore-ai/cli@latest

Dari sumber

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

Platform yang didukung: macOS, Linux, Windows — amd64 dan arm64.

Untuk variabel lingkungan (ARCHCORE_VERSION, ARCHCORE_INSTALL_DIR, GITHUB_TOKEN) dan pemecahan masalah PATH, lihat panduan instalasi lengkap di docs.archcore.ai.

Konfigurasi

Pengaturan disimpan di .archcore/settings.json dan dibuat selama archcore init.

Bidang	Deskripsi	Nilai
`sync`	Mode sinkronisasi. Cloud dan on-prem segera hadir.	`none` (hanya lokal), `cloud`, `on-prem`
`language`	Bahasa dokumen. Membantu agen menghasilkan dokumentasi dalam bahasa yang tepat.	String, default ke `en`

archcore config                              # show all settings
archcore config get <key>                    # get a specific value
archcore config set <key> <value>            # set a value

Pengembangan

Prasyarat

Go 1.24+

Build & uji

# 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

Struktur proyek

├── 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

Apakah Archcore seperti BMAD / Spec Kit / Memory Bank?

Tidak — ini memecahkan masalah yang berbeda. Peta singkat:

Alat	Kategori	Apa itu	Perbedaan Archcore
BMAD	Metodologi	Metodologi SDLC agentik — 12+ peran, 34+ alur kerja	Archcore menyimpan artefak; BMAD menentukan proses
Spec Kit	Metodologi	Alur kerja berbasis spesifikasi: `specify → plan → tasks → implement`, sekali jalan	Spec Kit adalah serah terima sekali jalan; Archcore memelihara graf hidup yang berkembang bersama basis kode
Agent OS	Metodologi	Ekstraksi standar basis kode + pengembangan berbasis spesifikasi	Posisi terdekat. Archcore menambahkan dokumen bertipe, relasi tervalidasi, dan kaskade ISO opsional
claude-mem / Mem0	Memori	Menangkap memori sesi otomatis, ingatan lintas agen	Alat memori mengingat apa yang Anda lakukan; Archcore menyimpan bagaimana sistem dibangun dan apa yang diputuskan
Cline Memory Bank	Dokumen	Berkas markdown skema tetap (`projectbrief`, `activeContext`, `systemPatterns`…)	Semangat yang sama, lebih sedikit seremoni. Archcore menambahkan relasi bertipe, validasi MCP, dan kaskade multi-langkah
CLAUDE.md / .cursorrules	Instruksi	Berkas datar tunggal yang dibaca agen saat sesi dimulai	Archcore menggantikan berkas instruksi yang terus bertambah dengan dokumen bertipe, berelasi, dan dapat dikueri

Pilih alat metodologi untuk alur pengembangan yang terarah. Pilih alat memori untuk kontinuitas sesi. Pilih Archcore ketika Anda menginginkan kebenaran proyek yang bertipe dan dapat dikueri — keputusan, aturan, dan arsitektur dari repositori ini — yang dihormati agen pengkodean Anda di setiap permintaan.

Tautan & lisensi

Dokumentasi: docs.archcore.ai
Situs web: archcore.ai
Plugin (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
Isu: github.com/archcore-ai/cli/issues
Lisensi: Apache 2.0