Indexes your codebase's public API and serves it via compact MCP tool responses.
Connect Codesurface to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Indexes your codebase's public API and serves it via compact MCP tool responses. The codesurface mcp server is what makes that connection.
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.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
File — Service.cs:32 → Read("Service.cs", offset=32, limit=15)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 keywordget_signature — Need exact signatureget_class — See all members on a classget_stats — Codebase overviewreindex — Incremental index update (mtime-based)The server ships on PyPI as codesurface, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Codesurface's toolset — File, file_path, include_tests and 5 more — is a fair guide to whether it matches your workflow. It is maintained by Codeturion; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| File | Service.cs:32 → Read("Service.cs", offset=32, limit=15) |
| 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) |
{
"mcpServers": {
"codesurface": {
"command": "uvx",
"args": ["codesurface", "--project", "/path/to/your/src"]
}
}
}Configuration as documented by the project. Restart the client after saving.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.