CC

codeturion/codesurface

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

21 stars 4 forks 품질 76 트렌드 14MIT

비싼 소스 파일 대신 AI 에이전트 즉시 API 조회를 제공합니다. C#, Go, Java, Python 및 TypeScript를 위한 MCP 서버.

개요

포즈 소스 파일, 공공 클래스 / 메타드 / 프로퍼토리 / 필드 / 일러스트를 추출하고 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) 지원되는 소스 파일 (Unity Assets/Scripts 폴더, Spring Boot 프로젝트, .NET src/ 트리, Node.js/React 프로젝트, Python 패키지 등)을 포함하는 모든 디렉토리의 Point --project. 언어는 자동 탐지입니다. AI 도구를 복원하고 물었다 : "MyService가 어떤 방법?" 프로젝트의 CLAUDE.md (또는 해당 지침 파일)에 이것을 추가하십시오. AI는 도구를 가지고 있지만 그에 대해 도달 할 때 모른다. search, get signature 및 get class는 두 개의 옵션 필터를 허용합니다. - file path: 디렉토리 접두사 또는 정확한 파일(예: "src/services/" 또는 "src/services/MergeService.

개요(AI 번역)

** MCP 서버는 시동에서 코베이스의 공개 API를 색인하고 컴팩트한 도구 응답을 통해 역할을하며, 토큰 vs 읽는 소스 파일을 저장합니다.**

포즈 소스 파일, 공공 클래스 / 메타드 / 프로퍼토리 / 필드 / 일러스트를 추출하고 5 MCP 도구를 통해 제공합니다. Claude Code, Cursor, Windsurf 또는 MCP 호환 AI 도구와 함께 작동합니다.

** 지원 언어 :** C# (.cs), C++ 헤더 ([T1]], .hpp], .hxx], .h++]), 이동 ([T5]]), 자바 (.java]), 파이썬 ([T7]]]), TypeScript/JavaScript ([T8]], .tsx, .js]], .js]]], .js]]], .js]]]

빠른 시작

.mcp.json에 추가:

Point --project] 지원되는 소스 파일(Unity Assets/Scripts]] 폴더, Spring Boot 프로젝트, .NET src/ 트리, Node.js/React 프로젝트, Python 패키지 등)를 포함하는 모든 디렉토리에 있습니다. 언어는 자동 탐지입니다.

AI 도구를 복원하고 요청 : * “MyService는 어떤 방법이 있습니까?”*

CLAUDE.md 스니펫

프로젝트의 CLAUDE.md에 이것을 추가하십시오 (또는 해당 지침 파일). **이 단계는 중요합니다. ** AI는 도구를 가지고 있지만 그에 대해 도달 할 때 모른다.

₢ 킹

도구

도구 용도 예

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 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()` |
GitHub에서 전체 README 보기

설치

uvx codesurface --project /path/to/your/src
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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