How do I install the codesurface mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Codesurface MCP Server

Indexes your codebase's public API and serves it via compact MCP tool responses.

Local serverstdioPython

What is the Codesurface MCP Server?

Indexes your codebase's public API and serves it via compact MCP tool responses.

What the server does

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
file_path	scope results to a directory prefix or exact file (e.g. "src/services/" or "src/services/MergeService.ts")
include_tests	include test files in results (default false). Detects __tests__/, tests/, test/, .test., .spec., _test., test_*
search	Find APIs by keyword
get_signature	Need exact signature
get_class	See all members on a class
get_stats	Codebase overview
reindex	Incremental index update (mtime-based)

How to install the Codesurface MCP Server

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

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

“Use Codesurface to File.”
“Use Codesurface to file path.”
“Use Codesurface to include tests.”

Frequently asked questions

Indexes your codebase's public API and serves it via compact MCP tool responses. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.