codeturion avatar

Codesurface

codeturion/codesurface

Indexes your codebase's public API surface at startup and serves it through five compact MCP tools: search by keyword, get exact signatures, pull full class references, view stats, and reindex incrementally. Supports C#, C++, Go, Java, Python, and TypeScript. Each result includes file paths and line numbers so Claude can do targeted reads instead of loading entire files. The benchmark shows 56–77% token reduction compared to grep-based workflows across real projects like vscode, Paper, and guava. Point it at any source directory with `--project`, add the CLAUDE.md snippet so the agent knows when to reach for it, and restart. Works best when paired with targeted Read calls using the returned line ranges.

GitHub stars
22
tools
5
transport
STDIO
last updated
Apr 28, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

searchFind APIs by keyword.

Find APIs by keyword.

No parameter schema in public metadata yet.

get_signatureExact signature by name or FQN.

Exact signature by name or FQN.

No parameter schema in public metadata yet.

get_classFull class reference card with all public members.

Full class reference card with all public members.

No parameter schema in public metadata yet.

get_statsOverview of indexed codebase.

Overview of indexed codebase.

No parameter schema in public metadata yet.

reindexIncremental index update (mtime-based).

Incremental index update (mtime-based).

No parameter schema in public metadata yet.

Sponsors

Readme

Details

Repository
github.com/codeturion/codesurface
Package
codesurface
Transport
STDIO
Registry
MCP registry, active

More from codeturion