mcp-stama: AI 에이전트를 위한 고성능 Rust MCP 서버

mcp-stama는 Rust로 작성된 고성능 Model Context Protocol (MCP) 서버로, 단일 정적 바이너리를 통해 AI 코딩 에이전트에게 로컬 컨텍스트를 제공하도록 설계되었습니다. Node.js 또는 Python 런타임과 관련된 오버헤드를 제거하여, 콜드 스타트 시간을 초 단위에서 2밀리초 미만으로 단축하고 메모리 사용량을 수백 메가바이트에서 10MB 미만으로 낮춥니다.

성능 벤치마크

mcp-stama는 모든 주요 리소스 지표에서 Node.js 또는 Python 기반의 기존 MCP 서버를 크게 능가합니다. 네이티브 Rust 구현을 활용하여 즉각적인 실행과 최소한의 시스템 영향을 달성합니다.

Metric	Legacy MCP Servers (Node / Python)	mcp-stama (Rust)
Cold Startup Time	1,500ms – 3,000ms	< 2ms
p50 Execution Latency	150ms – 800ms	300µs – 5ms
Memory Footprint (RSS)	180 MB – 350 MB	< 10 MB
Dependencies	100+ packages	Zero external runtimes
Installation	Requires Node.js / Python setup	Single static binary

특정 도구에 대한 내부 마이크로 벤치마크는 이러한 효율성을 더욱 입증합니다:

Tool Name	Invocations	p50 Latency	p99 Latency	Memory Footprint (RSS)
`docker_watcher`	100	327 µs	1.66 ms	< 10 MB
`git_snapshot`	100	462 µs	1.36 ms	< 10 MB
`fast_grep`	100	5.05 ms	8.72 ms	< 10 MB

내장 고성능 도구

mcp-stama는 무거운 자식 프로세스를 생성하거나 프롬프트 토큰을 낭비하지 않고 AI 에이전트에게 깊은 로컬 컨텍스트를 제공하도록 설계된 여러 전문화된 도구를 포함합니다.

fast_grep

이 도구는 밀리초 미만의 파일 검색 및 regex 스캐닝을 제공합니다. ignore::WalkBuilder를 활용하여 .gitignore 및 .ignore 파일을 자동으로 준수하면서 바이너리 및 숨김 파일을 건너뜁니다.

git_snapshot

gix (gitoxide)를 기반으로 하는 이 도구는 순수 Rust Git 검사기입니다. HEAD 커밋, 브랜치 정보, 라인 델타 및 파일 상태를 네이티브하게 가져오며, 외부 git 실행 파일을 호출할 필요가 없습니다.

docker_watcher

이 도구는 bollard 및 sysinfo를 사용하여 즉각적인 호스트 및 컨테이너 진단을 제공합니다. AI 에이전트에게 실행 중인 Docker 컨테이너, 시스템 메모리, CPU 코어 및 매핑된 포트를 가시화할 수 있게 해줍니다.

설치 및 설정

mcp-stama는 단일 정적 바이너리로 배포되며 AI 에디터와의 통합을 간소화하기 위한 자동 설정 도구를 포함합니다.

설치

macOS / Linux: curl -fsSL https://raw.githubusercontent.com/StamManif/mcp-stama/main/install.sh | sh
Windows (PowerShell): iwr -useb https://raw.githubusercontent.com/StamManif/mcp-stama/main/install.ps1 | iex
Cargo: cargo install mcp-stama

자동 설정

사용자는 다음 플래그를 사용하여 에디터 설정에 서버를 자동으로 주입할 수 있습니다:

Claude Desktop: mcp-stama --install-claude
Cursor: mcp-stama --install-cursor

수동 설정

수동 설정을 위해, 각 설정 파일(~/.cursor/mcp.json 또는 Claude Desktop용 claude_desktop_config.json)에 다음을 추가하십시오:

{
  "mcpServers": {
    "mcp-stama": {
      "command": "mcp-stama",
      "args": []
    }
  }
}

기술 아키텍처

mcp-stama는 Pure Stdio JSON-RPC 2.0 인터페이스를 구현합니다. JSON-RPC 프레임 프로토콜을 엄격하게 준수하기 위해, 모든 진단 및 로깅 출력은 stderr로 라우팅되어 stdout이 프로토콜 트래픽에만 전용되도록 보장합니다.

요청 흐름은 선형 경로를 따릅니다: AI Client (Cursor/Claude) $\rightarrow$ StdioTransport $\rightarrow$ JsonRpcRequest/Response $\rightarrow$ ToolRegistry $\rightarrow$ Specific Tool (fast_grep, git_snapshot, or docker_watcher).