MCP服务器在启动时索引你代码库的公共API，并通过简洁工具响应提供，节省令牌而非读取源文件。

解析源文件，提取公共类/方法/属性/字段/事件，并通过5个MCP工具提供。支持Claude Code、Cursor、Windsurf或任何兼容MCP的AI工具。

支持的语言： C# （[.cs）、C++ 头部（.h、.hpp、.hxx、.h++）、Go （.go）、Java （.java）、Python （.py）、TypeScript/JavaScript （.ts、.tsx、.js、.jsx）

快速启动

补充你的.mcp.json：

将--project指向包含支持源文件的任意目录（Unity的Assets/Scripts文件夹、Spring Boot项目、.NET src/树、Node.js/React项目、Python包等）。语言会自动检测。

重启你的AI工具，问：“MyService有哪些方法？”*

CLAUDE.md 片段

将此添加到你的项目的CLAUDE.md（或等效指令文件）中。**这一步很重要。**没有它，AI拥有工具，但不会知道何时使用它们。

`

工具

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()` |