Archcore MCP Server

resmi

Yerel stdio MCP sunucusu, yapay zeka kodlama ajanlarının deponuzdan doğrudan yapılandırılmış mimari, kurallar ve kararları okumasını ve sürdürmesini sağlar.

GitHub

Dokümantasyon

Archcore CLI

Yapay zeka ajanınız tahmin etmeyi bırakır ve mimarinizi takip etmeye başlar.

Git kodunuzu taşır. CI/CD teslimatınızı taşır. Archcore anlayışınızı taşır.

Archcore kararlarınızı, kurallarınızı ve teamüllerinizi Git'te saklar — böylece yapay zeka ajanınız bunları otomatik olarak takip eder. Claude Code, Cursor, Copilot, Gemini CLI, Codex, OpenCode, Roo Code ve Cline ile çalışır.

Archcore bir CLI ve yerel bir stdio MCP sunucusu olarak gelir — herhangi bir MCP uyumlu kodlama ajanı, standart araçlar aracılığıyla repo bağlamınızı okuyup yazabilirken, Claude Code / Cursor eklentisi daha üst düzey bir iş akışı katmanı ekler.

Claude Code veya Cursor mu kullanıyorsunuz? CLI'ı Archcore Plugin ile eşleştirin — aynı motor, artı kutudan çıkan beceriler, niyet komutları ve koruma korkulukları. Yalnızca CLI ile devam etmek de harikadır — diğer tüm ajanlarda çalışır.

60 saniyede

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

Ardından yapay zeka ajanınızı açın ve şunu söyleyin:

"Birincil depolama için PostgreSQL kullanıyoruz. Bu kararı kaydet."

Tamamlandı. Artık .archcore/ içinde, gelecekteki her oturumun — herhangi bir ajanda — okuyabileceği yapılandırılmış bir ADR var.

Windows'ta mısınız? PowerShell kullanın: irm https://archcore.ai/install.ps1 | iex. WSL, go install ve diğer seçenekler için Kurulum yöntemleri veya tam kurulum kılavuzuna bakın.

Yapay zekanıza şunun gibi şeyler sorun

Deponuzda birkaç belge olduğunda, ajanınız bunları kullanabilir. Deneyin:

"Auth modülüne dokunmadan önce, burada hangi ADR'ler ve kurallar geçerli?"

Ajan, tek bir satırı düzenlemeden önce o alana bağlı ilgili kararları ve kuralları yükler.

"Yeni bir API işleyici ekleyin ve bu deponun teamüllerini takip edin."

Ajan, eşleşen kuralı (ör. "işleyiciler src/api/handlers/ içinde bulunur") ortaya çıkarır ve kodu mimarinizin söylediği yere yerleştirir.

"Hata işleme kuralımız nedir?"

Ajan, kod tabanındaki birkaç örnekten tahmin etmek yerine error-wrapping.rule.md dosyasını doğrudan .archcore/ içinden okur.

Önce bunları deneyin

Bu istemler yeni bağlam yakalar — kararlar, kurallar, planlar, olaylar. Her biri, ajanın (veya herhangi bir ekip arkadaşının) daha sonra yeniden kullanabileceği yapılandırılmış bir belge oluşturur.

Yeni repo mu? archcore init, .archcore/ oluşturur. MCP sunucusu boş bir repoda da çalışır ve bir init_project aracı sunar, böylece ajan sizin için başlangıç yapabilir.

"Birincil veritabanımız için MongoDB yerine PostgreSQL kullanmaya karar verdik. Bu kararı kaydet."

Bağlam, karar, dikkate alınan alternatifler ve sonuçlarla birlikte infrastructure/use-postgres.adr.md oluşturur.

"Bir ekip teamülümüz var: hataları her zaman fmt.Errorf ve %w kullanarak bağlamla sarın. Bunu bir kural haline getirin."

Zorunlu rehberlik, gerekçe ve iyi/kötü kod örnekleriyle backend/error-wrapping.rule.md oluşturur.

"Geçen hafta, boşta kalan bağlantılar geri dönüştürülmediği için bir bağlantı havuzu tükenmesi olayı yaşadık. Tekrarlamamak için bunu belgeleyin."

Kök neden analizi ve önleme adımlarıyla incidents/connection-pool-exhaustion.cpat.md oluşturur.

"Kullanıcı bildirimleri özelliği için bir PRD'ye ihtiyacım var — anlık bildirim, e-posta özetleri ve uygulama içi uyarılar."

Hedefler, kullanıcı hikayeleri, gereksinimler ve başarı metrikleriyle notifications/user-notifications.prd.md oluşturur.

"Bildirimler PRD'si için bir uygulama planı oluşturun ve bunları birbirine bağlayın."

notifications/notifications-implementation.plan.md oluşturur, ardından bir implements ilişkisi ile PRD'ye bağlar.

Bunlardan herhangi biri size hitap ediyorsa, Archcore'un geri kalanı da aynı şekilde — sadece yapılandırılmış.

Kurulumdan sonra ne değişir

Archcore olmadan, ajan:

mimarinizi görmezden gelir
teamüllerinizi bozar
zaten var olan mantığı tekrarlar
ekibinizin zaten verdiği kararları yeniden tartışır
her sohbette aynı teamüllerin tekrarlanmasını gerektirir
oturum bittiği anda proje gerçeğini kaybeder

Archcore ile, aynı istekler şu kodu üretir:

mimarinizin söylediği yere yerleşir
Git'te zaten bulunan ADR'lere, şartnamelere ve kurallara saygı duyar
oturum başlangıcında otomatik olarak yüklenen ekip teamüllerini takip eder
yeni kararları markdown mezarlıkları olarak değil, gelecekteki koruma korkulukları olarak yansıtır

Yapay zeka sisteminizi takip etmeli, onu tahmin etmemeli.

Archcore'u şu durumlarda kullanın

Ajanınız kod yazıyor, ancak bu deponun beklediği şekilde değil
CLAUDE.md / .cursorrules / AGENTS.md dosyalarınız büyümeye ve sapmaya devam ediyor
2'den fazla ajan veya 2'den fazla ana araçla (Claude Code + Cursor + Copilot) çalışıyorsunuz
Kararların, kuralların ve şartnamelerin sohbet geçmişinde değil, Git'te olmasını istiyorsunuz

Şunlar için değil — sohbet belleği, bir istem kütüphanesi veya tek seferlik şartnameden koda üreteci. Archcore, kodlama ajanları için bir repo gerçeklik katmanıdır, bir metodoloji kiti değil.

Neden sadece talimat dosyaları olmasın?

CLAUDE.md, AGENTS.md ve depo talimatları faydalı başlangıç noktalarıdır, ancak ekibiniz şunlara ihtiyaç duyduğunda yetersiz kalırlar:

birden fazla düz bellek dosyası
yapılandırılmış belge türleri — ADR'ler, kurallar, planlar, olaylar
birden fazla yapay zeka aracında yeniden kullanılabilir bağlam
kod tabanıyla birlikte büyüyen sürümlendirilmiş proje bilgisi
belgeler arası ilişkiler (bir PRD'yi uygulayan bir plan, bir ADR'yi genişleten bir RFC)
ajanların daha sonra alabileceği olay öğrenimleri ve yinelenen iş akışları

Talimat dosyaları ajana ne istediğinizi söyler. Archcore ajana sisteminizin nasıl çalıştığını söyler — böylece ajan sisteminizi tahmin etmek yerine takip edebilir.

Desteklenen ajanlar

Archcore CLI'ın kendisi yerel bir stdio MCP sunucusudur — bu, aşağıdaki tablodaki her MCP uyumlu ajan için paylaşılan entegrasyon yüzeyidir. Kancalar, ajanın desteklediği yerlerde proaktif oturum başlangıcı bağlamı ekler.

Ajan	Kancalar	MCP
Claude Code	evet	evet
Cursor	evet	evet
Gemini CLI	evet	evet
GitHub Copilot	evet	evet
OpenCode	—	evet
Codex CLI	—	evet
Roo Code	—	evet
Cline	—	manuel

Nasıl çalışır

Deponuzu başlatın archcore init, .archcore/ oluşturur ve desteklenen ajanlar için entegrasyonları kurar.
Kalıcı bağlam yakalayın Mimari kararları, kuralları, planları, ürün belgelerini ve olay öğrenimlerini yapılandırılmış Markdown dosyaları olarak saklayın.
Ajanların onu yeniden kullanmasına izin verin Kancalar ve MCP, kodlama ajanlarınızın mevcut bağlamı okumasına ve gerçek çalışma sırasında belgeler oluşturmasına veya güncellemesine olanak tanır.
Git'te saklayın Bağlam değişikliklerini kod gibi inceleyin, zaman içinde geliştirin ve araçlar arasında taşınabilir tutun.

Zihinsel model

Archcore CLI bağlam derleyicisidir — dağınık belgeleri yapılandırılmış, makine tarafından okunabilir bağlama dönüştürür. MCP ve kancalar çalışma zamanıdır — ajanların gerçek çalışma sırasında bu bağlamı tüketmek için kullandığı yüzeydir. Claude Code ve Cursor için Archcore Plugin, üzerine inşa edilmiş daha üst düzey bir çalışma zamanıdır.

implicit repo knowledge  →  structured context  →  AI-readable system

`.archcore/` içinde ne bulunur

.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

Yapı serbest biçimlidir — belgeleri alana, özelliğe, ekibe veya deponuza uygun herhangi bir şeye göre düzenleyin. Kategoriler sanaldır ve dosya adındaki belge türünden çıkarılır (slug.type.md).

.archcore/ şunlar için kullanın:

mimari kararlar
kodlama kuralları ve teamülleri
uygulama planları
ürün gereksinimleri
olaylar ve postmortemler
yeniden kullanılabilir iş akışı bilgisi

Çalışan bir örnek için Archcore CLI deposunun kendisine bakın: bu depodaki .archcore/

Kutuda ne gelir

Vizyon, bilgi ve deneyim genelinde 18 belge türü
4 ilişki türü — related, implements, extends, depends_on
10 MCP aracı — list_documents, get_document, create_document, update_document, remove_document, search_documents, init_project, artı ilişki yönetimi (add_relation, remove_relation, list_relations)
5 çoklu belge istemi — MCP uyumlu ajanlardan eğik çizgi komutları olarak çağrılabilen basamakları izleyin
4 ajan için Kanca entegrasyonları (Claude Code, Cursor, Gemini CLI, GitHub Copilot) ve 8 ajan için MCP entegrasyonları

Belge türleri

Archcore bağlamı 3 bilgi katmanı halinde düzenler: Vizyon, Bilgi ve Deneyim.

Vizyon

Tür	Tam Adı	Açıklama
`prd`	Ürün Gereksinimleri Belgesi	Hedefler, kullanıcı hikayeleri, kabul kriterleri ve başarı metrikleri
`idea`	Fikir	Gelecekte keşif için bir ürün veya teknik fikrin hafif yakalanması
`plan`	Plan	Kabul kriterleri ve bağımlılıklarla aşamalı görev listesi

Archcore ayrıca yapılandırılmış keşif veya resmi ayrıştırmaya ihtiyaç duyan ekipler için iki ek gereksinim izini destekler:

Kaynaklar izi (MRD → BRD → URD) — gereksinimlerin nereden geldiğini yakalar:

Tür	Tam Adı	Açıklama
`mrd`	Pazar Gereksinimleri Belgesi	Pazar manzarası, TAM/SAM/SOM, rekabet analizi ve pazar ihtiyaçları
`brd`	İş Gereksinimleri Belgesi	İş hedefleri, paydaşlar, ROI ve iş kuralları
`urd`	Kullanıcı Gereksinimleri Belgesi	Kullanıcı personaları, yolculuklar, kullanılabilirlik gereksinimleri ve kabul kriterleri

ISO/IEC/IEEE 29148:2018 izi (BRS → StRS → SyRS → SRS) — gereksinimlerin nasıl ayrıştığını yakalar:

Tür	Tam Adı	Açıklama
`brs`	İş Gereksinimleri Şartnamesi	Misyon, hedefler, amaçlar ve iş operasyonel konsepti
`strs`	Paydaş Gereksinimleri Şartnamesi	Paydaş ihtiyaçları, operasyonel konsept ve kullanıcı gereksinimleri
`syrs`	Sistem Gereksinimleri Şartnamesi	Sistem fonksiyonları, arayüzler, performans ve tasarım kısıtları
`srs`	Yazılım Gereksinimleri Şartnamesi	Yazılım fonksiyonları, harici arayüzler ve detaylı davranışsal şartnameler

Çoğu proje için PRD kullanın. Yapılandırılmış gereksinim keşfine ihtiyacınız olduğunda kaynaklar izini ekleyin. Düzenlenmiş veya karmaşık çok ekipli sistemler için resmi izlenebilirliğe ihtiyacınız olduğunda ISO 29148'i ekleyin. Serbestçe karıştırın — bazı özellikler PRD kullanırken diğerleri tam basamağı kullanabilir.

Bilgi

Tür	Tam Adı	Açıklama
`adr`	Mimari Karar Kaydı	Bağlam, alternatifler ve sonuçlarla nihai bir teknik kararı yakalar
`rfc`	Yorum Talebi	Ekip incelemesi ve geri bildirime açık önemli bir değişiklik önerir
`rule`	Kural	Zorunlu rehberlik ve örneklerle kodlama veya süreç standardı
`guide`	Kılavuz	Belirli bir görevi tamamlamak için adım adım talimatlar
`doc`	Belge	Referans dokümantasyon, kayıtlar ve tanımlayıcı materyal
`spec`	Şartname	Bir sistem, bileşen, arayüz veya protokol için kanonik normatif sözleşme

Deneyim

Tür	Tam Adı	Açıklama
`task-type`	Görev Türü	Yinelenen bir görev için yeniden kullanılabilir kontrol listesi ve iş akışı
`cpat`	Kod Değişiklik Modeli	Bir hata veya olayın önleme adımlarıyla kök neden analizi

Her belge, YAML ön maddeli bir Markdown dosyasıdır:

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

## Context

...

Geçerli durumlar: draft, accepted ve rejected. Etiketler isteğe bağlıdır ve serbest biçimlidir — kesişen konuları işaretlemek için kullanın (security, golang, frontend).

Belge ilişkileri

Belgeler, diğer belgelere yönlendirilmiş ilişkilerle bağlanabilir:

related — genel ilişki
implements — kaynak, hedefin belirttiğini uygular
extends — kaynak, hedefin üzerine inşa eder
depends_on — kaynak, ilerlemek için hedefe ihtiyaç duyar

İlişkiler .sync-state.json içinde saklanır ve MCP araçları aracılığıyla yapay zeka ajanı tarafından otomatik olarak yönetilir.

Yapay zeka ajan entegrasyonu

Archcore, yapay zeka kodlama ajanlarıyla üç şekilde entegre olur:

Kancalar, oturum başlangıcında bağlam enjekte eder, böylece ajan ilk mesajdan itibaren .archcore/ belgelerinizin farkında olur.
MCP araçları, ajana gerçek zamanlı olarak belgeleri listeleme, arama, okuma, oluşturma, güncelleme ve bağlama yetenekleri verir. MCP sunucusu boş bir repoda da çalışır ve bir init_project aracı sunar, böylece ajanlar .archcore/'ü kendileri başlatabilir.
MCP istemleri, ajanınızdan eğik çizgi komutları olarak tetiklediğiniz hazır çoklu belge iş akışlarıdır.

İstemler

İstemler, tek bir çağrıda tam belge basamaklarını düzenler — ajan sizin için izdeki her belgeyi oluşturur ve bağlar. Çoğu MCP uyumlu ajan bunları eğik çizgi komutları olarak sunar (ör. /architecture_track); tam önek istemciye bağlıdır.

İstem	Yaptığı şey
`product_track`	fikir → PRD → plan (hafif özellik akışı)
`architecture_track`	ADR → şartname → plan (teknik tasarım + uygulama)
`standard_track`	ADR → kural → kılavuz (bir ekip standardını kodlama)
`sources_track`	MRD → BRD → URD (pazar / iş / kullanıcı keşfi)
`iso_track`	BRS → StRS → SyRS → SRS (resmi ISO 29148 basamağı)

Örnek. Ajanınızda /product_track feature="user notifications" çalıştırın. Ajan bir fikir taslağı hazırlar, bir PRD türetir, bir uygulama planı oluşturur ve bunları otomatik olarak bağlar.

Yerel MCP sunucusu

Archcore barındırılan bir hizmet gerektirmez. CLI yerel bir stdio MCP sunucusu çalıştırır:

archcore mcp

Varsayılan olarak archcore mcp, belgeleri geçerli dizinden sunar. Başka bir yere işaret etmek için --project /path/to/repo iletin (veya ARCHCORE_PROJECT_ROOT ayarlayın) — sunucu, çalışma alanınız olmayan bir dizinden başlatıldığında (örneğin, bir düzenleyici entegrasyonu tarafından) kullanışlıdır.

Claude Code'a bağlayın:

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

Veya desteklenen bir ajan için otomatik olarak kurun:

archcore mcp install --agent cursor

Entegrasyonları kurun

# 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

Komutlar

Komut	Açıklama
`archcore init`	`.archcore/` dizinini etkileşimli olarak başlat
`archcore doctor`	Archcore kurulumunuzu kontrol edin ve sorunları düzeltin
`archcore status`	.archcore/ yapısını ve belge sağlığını kontrol edin
`archcore config`	Ayarları görüntüleyin veya değiştirin
`archcore hooks install`	Algılanan yapay zeka ajanları için kancaları kurun
`archcore update`	Archcore'u en son sürüme güncelleyin
`archcore mcp`	MCP stdio sunucusunu çalıştırın
`archcore mcp install`	Algılanan ajanlar için MCP yapılandırmasını kurun

Güncelleme

archcore update

Komut, GitHub Sürümleri'nde daha yeni bir sürüm olup olmadığını kontrol eder, indirir, SHA-256 sağlama toplamını doğrular ve mevcut ikili dosyayı atomik olarak değiştirir.

Kurulum yöntemleri

macOS / Linux

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

Windows

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

archcore.exe'ü %LOCALAPPDATA%\Programs\archcore altına kurar ve kullanıcı PATH'nıza ekler. PATH değişikliğinin alınması için kurulumdan sonra yeni bir PowerShell penceresi açın.

Windows (WSL)

WSL'yi kurun, ardından içinde çalıştırın:

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

Go install

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

Kaynaktan

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

Desteklenen platformlar: macOS, Linux, Windows — amd64 ve arm64.

Ortam değişkenleri (ARCHCORE_VERSION, ARCHCORE_INSTALL_DIR, GITHUB_TOKEN) ve PATH sorun giderme için docs.archcore.ai adresindeki tam kurulum kılavuzuna bakın.

Yapılandırma

Ayarlar .archcore/settings.json içinde saklanır ve archcore init sırasında oluşturulur.

Alan	Açıklama	Değerler
`sync`	Senkronizasyon modu. Bulut ve şirket içi yakında geliyor.	`none` (yalnızca yerel), `cloud`, `on-prem`
`language`	Belge dili. Ajanın doğru dilde dokümantasyon oluşturmasına yardımcı olur.	String, varsayılan `en`

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

Geliştirme

Ön koşullar

Go 1.24+

Derleme ve test

# 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

Proje yapısı

├── 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 gibi mi?

Hayır — bunlar farklı sorunları çözer. Hızlı harita:

Araç	Kategori	Ne olduğu	Archcore nasıl farklılaşır
BMAD	Metodoloji	Ajansal SDLC metodolojisi — 12+ rol, 34+ iş akışı	Archcore artefaktları saklar; BMAD süreci belirler
Spec Kit	Metodoloji	Şartname güdümlü iş akışı: `specify → plan → tasks → implement`, tek seferlik	Spec Kit tek seferlik bir devir teslimdir; Archcore kod tabanıyla gelişen canlı bir graf tutar
Agent OS	Metodoloji	Kod tabanı standartları çıkarma + şartname güdümlü geliştirme	En yakın konumlanma. Archcore tipli belgeler, doğrulanmış ilişkiler ve isteğe bağlı bir ISO basamağı ekler
claude-mem / Mem0	Bellek	Oturum belleğini otomatik yakalar, ajanlar arası hatırlama	Bellek araçları ne yaptığınızı hatırlar; Archcore sistemin nasıl inşa edildiğini ve neye karar verildiğini saklar
Cline Memory Bank	Belgeler	Sabit şemalı markdown dosyaları (`projectbrief`, `activeContext`, `systemPatterns`…)	Aynı ruh, daha az tören. Archcore tipli ilişkiler, MCP doğrulaması ve çok adımlı basamaklar ekler
CLAUDE.md / .cursorrules	Talimatlar	Ajanın oturum başlangıcında okuduğu tek düz dosya	Archcore, büyüyen bir talimat dosyasını tipli, ilişkili, sorgulanabilir belgelerle değiştirir

Görüşlü bir geliştirme akışı için bir metodoloji aracı seçin. Oturum sürekliliği için bir bellek aracı seçin. Kodlama ajanınızın her istekte saygı duyduğu, tipli, sorgulanabilir proje gerçeği — bu deponun kararları, kuralları ve mimarisi — istediğinizde Archcore'u seçin.

Bağlantılar ve lisans

Dokümantasyon: docs.archcore.ai
Web sitesi: archcore.ai
Eklenti (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
Sorunlar: github.com/archcore-ai/cli/issues
Lisans: Apache 2.0