Codesurface MCP Server

by codeturion Your server? Claim it

local only

Codesurface runs on your own machine — the client starts it, so there is no endpoint to ping. 92 installs a week from pypi. Last commit 28 Jul 2026.

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

Installs per day peak 82 · avg 22 · -31% w/w

a month agotoday

Installs / week

pypi · codesurface

Stars

0 open issues

28 Jul 2026

Last commit

from GitHub

MIT

License

Python

What the code does

We read the source, 6 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Builds a file path from a variable src/codesurface/filters.py:116, [пакет] src/codesurface/filters.py:116

        return self._git_file_excludes(os.path.join(root, name))

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add codesurface -- uvx codesurface

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codesurface": {
      "command": "uvx",
      "args": [
        "codesurface"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.codesurface]
command = "uvx"
args = ["codesurface"]

.cursor/mcp.json

{
  "mcpServers": {
    "codesurface": {
      "command": "uvx",
      "args": [
        "codesurface"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "codesurface": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "codesurface"
      ]
    }
  }
}

Alternatives to Codesurface

same job, measured the same way

crowbar

by kushvinth

Retrieve CVEs and index them inside your codebase. One SQLite+FTS5 index, one CLI, one MCP server.

402 installs/wk local only

Symbols

by p1va

MCP server to read, inspect and troubleshoot codebase symbols

93 installs/wk local only

Gread

by nitrorcr

An MCP server that gives your AI access to the source code and docs of all public github repos

5 tools answering

Deepcontext

by wild-card

Advanced codebase indexing and semantic search MCP server

94 installs/wk local only

Docdex

by bekirdag

Fast per-repo documentation indexer and full-text search MCP server for codebases.

3 205 installs/wk local only

Github MCP Server

by crypto-ninja

AI-optimized GitHub MCP server: 112 tools, 98% token reduction, compact responses.

452 installs/wk local only

Codeforces

by pipeworx-io

Codeforces MCP — public read API.

513 installs/wk 52 tools answering

Automatised Pipeline

by cdeust

Codebase intelligence MCP server — index any repo into a property graph; 26 tools for agents.

local only

Codesurface — questions

Answers built from our own checks of this server.

Why is there no uptime for Codesurface?

Codesurface runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package codesurface was installed 92 times last week.

How do I connect Codesurface?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls codesurface straight from pypi; nothing to host, nothing to sign up for.

How many people use Codesurface?

The pypi package codesurface was installed 92 times in the last week. Week over week that is -31%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Codesurface open source?

Yes — it is published under the MIT licence, written in Python and 21 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.