Is io.github.Codeturion/codesurface safe to use?

io.github.Codeturion/codesurface has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.Codeturion/codesurface?

io.github.Codeturion/codesurface supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.Codeturion/codesurface do?

io.github.Codeturion/codesurface provides 5 tools: search, get_signature, get_class, get_stats, reindex. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.Codeturion/codesurface?

io.github.Codeturion/codesurface is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.Codeturion/codesurface actively maintained?

io.github.Codeturion/codesurface is recently maintained — last commit was 57 days ago. It has 21 GitHub stars.

io.github.Codeturion/codesurface

codesurface

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

21 5 tools GitHub PyPI

No known CVEs

No license

Maintained

Last commit 57d ago

Works with most clients

Transport: stdio, sse, http

5 tools · ~495 tok

Grade A · 0.2% of 200K ctx

Edit this pageView history

Developer Tools

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

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

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-codeturion-codesurface)](https://mcppedia.org/s/io-github-codeturion-codesurface)

Read me

What io.github.Codeturion/codesurface does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'codesurface' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked codesurface against OSV.dev.

Inventory

Tools (5)

Click any tool to inspect its schema.

~495 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Codeturion/codesurface safe to use?: io.github.Codeturion/codesurface has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.Codeturion/codesurface?: io.github.Codeturion/codesurface supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.Codeturion/codesurface do?: io.github.Codeturion/codesurface provides 5 tools: search, get_signature, get_class, get_stats, reindex. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.Codeturion/codesurface?: io.github.Codeturion/codesurface is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.Codeturion/codesurface actively maintained?: io.github.Codeturion/codesurface is recently maintained — last commit was 57 days ago. It has 21 GitHub stars.

Similar servers

Others in developer-tools

View all →

XcodeBuildMCP97

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0k 2

Jscpd97

Copy/paste detector for programming source code, supports 223 formats. AI-ready with token-efficient reporter, skill and MCP server.

5.8k 1

XcodeBuildMCP97

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

6.0k 1

Supabase MCP Server96

Manage Supabase projects — databases, auth, storage, and edge functions

2.8k 4

MCP Security Weekly

Get CVE alerts and security updates for io.github.Codeturion/codesurface and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Developer Tools

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

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

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-codeturion-codesurface)](https://mcppedia.org/s/io-github-codeturion-codesurface)

Read me

What io.github.Codeturion/codesurface does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'codesurface' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

codesurface

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?"

CLAUDE.md Snippet

Add this to your project's CLAUDE.md (or equivalent instructions file). This step is important. Without it, the AI has the tools but won't know when to reach for them.

## Codebase API Lookup (codesurface MCP)

Use codesurface MCP tools BEFORE Grep, Glob, Read, or Task (subagents) for any class/method/field lookup. This applies to you AND any subagents you spawn.

| Tool | Use when | Example |
|------|----------|---------|
| `search` | Find APIs by keyword | `search("MergeService")` |
| `get_signature` | Need exact signature | `get_signature("TryMerge")` |
| `get_class` | See all members on a class | `get_class("BlastBoardModel")` |
| `get_stats` | Codebase overview | `get_stats()` |

Every result includes file path + line numbers. Use them for targeted reads:
- `File: Service.cs:32` → `Read("Service.cs", offset=32, limit=15)`
- `File: Converter.java:504-506` → `Read("Converter.java", offset=504, limit=10)`

Never read a full file when you have a line number. Only fall back to Grep/Read for implementation details (method bodies, control flow).

Tools

Tool	Purpose	Example
`search`	Find APIs by keyword	"MergeService", "BlastBoard", "GridCoord"
`get_signature`	Exact signature by name or FQN	"TryMerge", "CampGame.Services.IMergeService.TryMerge"
`get_class`	Full class reference card with all public members	"BlastBoardModel" → all methods/fields/properties
`get_stats`	Overview of indexed codebase	File count, record counts, namespace breakdown
`reindex`	Incremental index update (mtime-based)	Only re-parses changed/new/deleted files. Also runs automatically on query misses

search, get_signature, and get_class

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked codesurface against OSV.dev.

Inventory

Tools (5)

Click any tool to inspect its schema.

~495 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Codeturion/codesurface safe to use?: io.github.Codeturion/codesurface has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.Codeturion/codesurface?: io.github.Codeturion/codesurface supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.Codeturion/codesurface do?: io.github.Codeturion/codesurface provides 5 tools: search, get_signature, get_class, get_stats, reindex. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.Codeturion/codesurface?: io.github.Codeturion/codesurface is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.Codeturion/codesurface actively maintained?: io.github.Codeturion/codesurface is recently maintained — last commit was 57 days ago. It has 21 GitHub stars.