mcpbeat

Codesurface MCP Server

io.github.Codeturion/codesurface
local only

Codesurface runs on your own machine — the client starts it, so there is no endpoint to ping. 151 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 73 · avg 25 · -4% w/w
a month agotoday
151
Installs / week
pypi · codesurface
21
Stars
0 open issues
28 Jul 2026
Last commit
0 releases in 90 days
MIT
License
Python

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.

run in your terminal
claude mcp add codesurface -- uvx codesurface
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "codesurface": {
      "args": [
        "codesurface"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.codesurface]
command = "uvx"
args = ["codesurface"]
.cursor/mcp.json
{
  "mcpServers": {
    "codesurface": {
      "args": [
        "codesurface"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "codesurface": {
      "args": [
        "codesurface"
      ],
      "command": "uvx"
    }
  }
}

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 151 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 with the file path 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 151 times in the last week. Week over week that is -4%. 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.