codesurface

MCP.Pizza Chef: Codeturion

Instead of having your AI read entire source files, codesurface indexes your project's public classes, methods, and properties so your AI can quickly find exact API details. It works with popular editors like VS Code and Cursor, supports multiple languages including Python, Java, and TypeScript, and helps your AI give precise code answers faster. Setup requires adding codesurface to your MCP configuration and pointing it to your source folder.

Coding
Other

Use This MCP server To

Look up all methods in a class instantly Find exact method signatures by name Search for APIs by keyword across my code Get an overview of my codebase structure Update the API index after code changes Find file and line number for a class or method

README

codesurface

PyPI Version PyPI Downloads MCP Registry GitHub Stars GitHub Last Commit Languages License: MIT Python 3.10+ Blog Post

MCP server that indexes your codebase's public API at startup and serves it via compact tool responses, saving tokens vs reading source files.

Parses source files, extracts public classes/methods/properties/fields/events, and serves them through 5 MCP tools. Works with Claude Code, Cursor, Windsurf, or any MCP-compatible AI tool.

Supported languages: C# (.cs), C++ headers (.h, .hpp, .hxx, .h++), Go (.go), Java (.java), Python (.py), TypeScript/JavaScript (.ts, .tsx, .js, .jsx)

Quick Start

Add to your .mcp.json:

{
  "mcpServers": {
    "codesurface": {
      "command": "uvx",
      "args": ["codesurface", "--project", "/path/to/your/src"]
    }
  }
}

Point --project at any directory containing supported source files (a Unity Assets/Scripts folder, a Spring Boot project, a .NET src/ tree, a Node.js/React project, a Python package, etc.). Languages are auto-detected.

Restart your AI tool and ask: "What methods does MyService have?"

codesurface FAQ

Can I use this to quickly find class methods in my codebase?
Yes — codesurface indexes your code’s public API so your AI can instantly look up classes, methods, and properties without reading full files.
Can I use this with VS Code or Cursor?
Yes — codesurface works with VS Code, Cursor, Windsurf, and any MCP-compatible AI tool.
Do I need an API key or account to use codesurface?
No — it runs locally and indexes your project without requiring external accounts or keys.
How hard is it to set up codesurface?
It requires developer setup — you add it to your MCP config and point it to your source folder.
Which programming languages does codesurface support?
It supports C#, C++, Go, Java, Python, and TypeScript/JavaScript source files.
Can I update the index after changing code?
Yes — codesurface supports incremental reindexing of changed files automatically.