yeuxuan/ace-mcp-node

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

359 stars 38 forks 품질 68 트렌드 19

Acemcp는 Claude, GPT 등과 같은 AI 비서에 코드베이스 인덱싱 및 의미 검색 기능을 제공하기 위해 설계된 고성능 MCP(모델 컨텍스트 프로토콜) 서버입니다. Acemcp를 통해 AI 어시스턴트는 대규모 코드베이스를 📊 빠르게 검색하고 이해하고, 줄 번호가 포함된 정확한 코드 스니펫🤖을 얻으며, 인덱스를 점진적으로 자동으로 업데이트🌐하고, 웹 인터페이스를 통해 관리 및 디버깅할 수 있습니다 🔍

개요

이는 고성능 MCP(모델 컨텍스트 프로토콜) 서버로, AI 비서(예: Claude, GPT 등)에 ** 및 ** 기능을 제공하기 위해 설계되었습니다. Acemcp를 통해 AI 비서들은 다음과 같은 기능을 수행할 수 있습니다: - 🔍 대규모 코드베이스를 빠르게 검색 및 이해 - 📊 줄 번호가 포함된 정확한 코드 조각 제공 - 🤖 자동 증분 인덱스 업데이트 - 🌐 웹 인터페이스를 통한 관리 및 디버깅 - ✅ - 새로 작성되거나 수정된 파일만 인덱싱 - ✅ - 배치 작업 및 자동 재시도 지원 - ✅ - 큰 파일은 자동으로 여러 블록으로 나뉘어 - ✅ - SHA-256 해시는 중복 업로드를 방지합니다 - ✅ - 풀타입 지원 - ✅ - 실시간 로깅, 구성 관리, 도구 디버깅 - ✅ 관련 없는 파일 자동 제외 - ✅ - 설정 가능한 로그 레벨 및 회전 - ✅ - Windows/Unix 경로의 통합 처리 - ✅ - UNC 경로, /mnt 자동 변환 - ✅ - UTF-8, GBK, GB2312, Latin-1 - ✅ - 공유 구성 및 데이터 형식 - ✅ - SDK의 완전한 구현 - ✅ - 의미 탐색 코드 스니펫 - ✅ - 표준 입출력 통신 - ✅ - 명령줄 매개변수 + 구성 파일 - > = 18.0.0 - > = 8.0.0 (또는 yarn, pnpm) - : Windows 10+, Linux, macOS, WSL 2 그래픽 인터페이스를 이용해 http://localhost:8080 접근: - 📊 서버 상태 보기 - ⚙️ 구성 파일 편집 - 📝 실시간 로그 보기 - 도구 🛠 디버그 테스트

개요(AI 번역)

📑 목차

소개
핵심 기능
빨리 시작
설치
구성
사용자 가이드
MCP 클라이언트 구성
도구 설명
웹 관리 인터페이스
WSL 지원
API 문서
예시 시나리오
개발 가이드
문제 해결
호환성
기여
면허

📖 서론

Acemcp는 AI 어시스턴트(예: Claude, GPT 등)를 위해 설계된 고성능 MCP(모델 컨텍스트 프로토콜) 서버로, 코드베이스 인덱싱 및 의미 검색 기능을 제공합니다. Acemcp를 통해 AI 어시스턴트는 다음과 같은 기능을 수행할 수 있습니다:

🔍 대규모 코드베이스를 빠르게 검색하고 이해하기
📊 행 번호가 포함된 정확한 코드 스니펫 획득
🤖 자동 증분 인덱스 업데이트
🌐 웹 인터페이스를 통한 관리 및 디버깅

**왜 ACEMCP를 선택했나요? **

특징	설명
설정 시작 0	구성은 첫 실행 시 자동으로 생성됩니다
증분 인덱스	변경 파일만 빠르고 효율적으로 처리합니다
크로스 플랫폼	Windows, Linux, macOS, WSL에서 완전 지원
멀티코드	UTF-8, GBK, GB2312, 라틴-1
AI 친화적	파일 경로와 줄 번호가 포함된 서식 코드 조각을 반환함

⭐ 핵심 기능

🚀 성능 최적화

✅ 증분 인덱스 - 새로 작성되거나 수정된 파일만 인덱싱합니다
✅ 배치 업로드 - 배치 작업 및 자동 재시도 지원
✅ 스마트 분할 - 큰 파일을 여러 블록으로 자동 분할함
✅ 캐싱 메커니즘 - SHA-256 해시는 중복 업로드를 방지합니다

🛠 개발자 친화적

✅ TypeScript - 완전한 타입 지원
✅ 웹 인터페이스 - 실시간 기록, 구성 관리, 도구 디버깅
✅ .gitignore support - 관련 없는 파일을 자동으로 제외함
✅ 상세 로그 - 설정 가능한 로그 레벨 및 회전

🌍 호환성

✅ 크로스 플랫폼 경로 - Windows/Unix 경로의 통합 처리
✅ 완전한 WSL 지원 - UNC 경로 및 /mnt 자동 변환
✅ 다중 인코딩 지원 - UTF-8, GBK, GB2312, Latin-1
✅ Python 버전 호환 - 공유 구성 및 데이터 형식

🎯 MCP 통합

✅ 표준 MCP 프로토콜 - SDK의 완전한 구현
✅ search_context 도구 - 의미 검색 코드 스니펫
✅ STDIO 전송 - 표준 입출력 통신
✅ 유연한 구성 - 명령줄 매개변수 + 구성 파일

🚀 빨리 시작하세요

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

설치

npx acemcp-node

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "acemcp": {
      "command": "npx",
      "args": ["acemcp-node"],
      "env": {}
    }
  }
}