mcp-code

🇬🇧 English | 🇹🇷 Turkce

AI kodlama ajanlari icin dogru kod dilimini bulan, sinirli degisiklik planlayan, etkiyi tahmin eden ve hedefli dogrulama calistiran semantik MCP sunucusu.

Neden mcp-code?

• 🧠 Dusuk degerli repo kesfini azaltir ve ajanlari dogru slice uzerinde calistirir.
• ✍️ Planlama ile mutasyonu ayirir; degisiklikler daha kontrollu ve gozden gecirilebilir olur.
• 🔎 Kod degismeden once blast radius ve contract etkisini gorunur hale getirir.
• ✅ Ilk olarak en kucuk yararli verification setini calistirir, gerekirse kapsami buyutur.
• 📦 @vaur94/mcpbase uzerine paket temelli kurulur; fork veya kaynak kopyasi degildir.

Quick Start

1. Depoyu klonla ve bagimliliklari yukle

git clone https://github.com/vaur94/mcp-code.git
cd mcp-code
npm ci
npm run build

2. Config dosyasi olustur

Baslangic noktasi olarak examples/mcp-code.config.json dosyasini kullan.

{
  "server": {
    "name": "mcp-code",
    "version": "0.1.0"
  },
  "logging": {
    "level": "info",
    "includeTimestamp": false
  },
  "workspace": {
    "rootPath": "/absolute/path/to/repository",
    "include": ["src/**/*.{ts,tsx,js,jsx}", "tests/**/*.{ts,tsx,js,jsx}"],
    "exclude": ["**/node_modules/**", "**/dist/**", "**/coverage/**"]
  },
  "security": {
    "commands": {
      "allowed": ["npm"]
    },
    "paths": {
      "allowed": ["/absolute/path/to/repository"]
    }
  }
}

3. MCP host'unu build cikisina bagla

{
  "mcpServers": {
    "mcp-code": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-code/dist/index.js"],
      "env": {
        "MCP_CODE_CONFIG": "/absolute/path/to/mcp-code.config.json"
      }
    }
  }
}

4. Semantik workflow'u baslat

1. resolve_code_slice cagir
2. explain_slice cagir
3. plan_safe_edit ile sinirli degisiklik plani uret
4. Onayli duzenlemeyi apply_safe_edit ile uygula
5. analyze_impact ile etkiyi incele
6. verify_slice ile degisen scope'u dogrula

Tool Surface

| Tool | Amaci | | -------------------- | ---------------------------------------------------------------------------------------------- | | resolve_code_slice | Bir sembol, dosya veya kodlama hedefi icin en kucuk yararli semantik calisma alanini bulur. | | explain_slice | Slice'i sorumluluklar, kisitlar, contract'lar ve riskler olarak sikistirir. | | plan_safe_edit | Invariant'lari, dokunulan dosyalari ve verification adimlarini iceren sinirli bir plan uretir. | | apply_safe_edit | Sadece planlanan sembol ve dosya kapsaminda duzenleme uygular. | | analyze_impact | Blast radius, bagimli alanlar ve contract maruziyetini tahmin eder. | | verify_slice | Hedefli dogrulama calistirir ve hatalari dokunulan kapsama gore gruplar. |

Mimari Ozeti

• src/index.ts, sunucuyu @vaur94/mcpbase uzerinden baslatir.
• src/context/, paylasilan servis kapsayicisini ve tipli execution context'i olusturur.
• src/infrastructure/repository-analyzer.ts, slice cozumleme, aciklama, planlama, impact analizi ve kontrollu mutation mantigini tutar.
• src/infrastructure/verification-runner.ts, slice scope'una gore repo komutlarini secip calistirir.
• src/tools/, sabit altı toolluk public surface'i expose eder.

Dokumantasyon

• 📘 Dokuman merkezi: docs/README.md
• 🇬🇧 English docs: docs/en/README.md
• 🇹🇷 Turkce docs: docs/tr/README.md
• 🧭 Baslangic kilavuzu: docs/en/user-guide/getting-started.md
• ⚙️ Konfigurasyon: docs/en/user-guide/configuration.md
• 🔌 Host entegrasyonu: docs/en/integration/opencode.md
• 🏛️ Mimari: docs/en/architecture/overview.md
• 🧰 Tool referansi: docs/en/api/tool-reference.md

Gelistirme

npm ci
npm run lint
npm run typecheck
npm run test
npm run test:protocol
npm run build
npm run ci:check

Release Durumu

• GitHub release otomasyonu main uzerinde aktif.
• release-please, conventional commit gecmisine gore release PR acip gunceller; bu PR merge edilince GitHub release olusturulur.
• Publish hedefi @vaur94/mcp-code; unscoped mcp-code paketi baska bir maintainer'a ait oldugu icin bu repodan trusted publishing'e baglanamaz.
• @vaur94/mcp-code icin ilk publish hala bir kez manuel yapilmalidir; sonrasinda GitHub OIDC tabanli trusted publishing devreye girebilir.
• .github/workflows/publish.yml, publish oncesi npm run ci:check ve npm run pack:dry-run ile paketi dogrular.
• Gercek npm publish adimi published release eventiyle calisir ve GitHub tag'inin package.json surumuyle eslestigini kontrol eder.
• Release PR'larda CI'nin otomatik calismasi isteniyorsa GitHub PAT tabanli opsiyonel bir RELEASE_PLEASE_TOKEN secret'i eklenmelidir.

Repo Yapisi

mcp-code/
├── src/                 # Runtime girisi, servisler, semalar ve tool adapter'lari
├── tests/               # Unit, integration, protocol ve fixture'lar
├── docs/                # English + Turkce urun ve gelistirici dokumanlari
├── examples/            # Kopyalanabilir config ve host ornekleri
├── .github/             # CI, release, issue, PR ve hijyen otomasyonu
└── AGENTS.md            # AI ajanlari icin repo bilgi tabani

Katki

Katkilar aciktir. CONTRIBUTING.tr.md ile basla, npm run ci:check calistir ve degisiklikleri semantik workflow siniri ile uyumlu tut.

Lisans

MIT. Ayrintilar icin LICENSE dosyasina bak.