30 lines (21 loc) · 1.42 KB

Architecture Overview

Türkçe sürüm: docs/tr/architecture/overview.md

mcp-code follows a slice-first architecture on top of @vaur94/mcpbase.

Runtime split

@vaur94/mcpbase owns server bootstrap, config loading, telemetry, logging, and MCP runtime plumbing.
mcp-code owns semantic analysis, repository policies, workflow tools, memory, and verification routing.

Core layers

Layer	Responsibility
`src/config`	Runtime config schema and defaults
`src/context`	Shared service creation and typed execution context
`src/contracts`	Tool-facing input and output schemas
`src/infrastructure`	Workspace analysis, repository memory, and verification execution
`src/tools`	Thin public adapters around the six workflow tools

Request flow

Runtime loads config and boots the server.
A tool request creates or reuses the shared service container.
The repository analyzer resolves semantic scope.
Memory stores slices, plans, impacts, and verification reports for follow-up steps.
Verification runs only when routed through the bounded workflow.

Last updated: 2026-03-10