qy527145/acemcp

API development

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

804 stars 112 forks 품질 74 트렌드 22Apache-2.0

Repository Install

ACE(Augment Context Engine)를 MCP로 바꾸는 프로젝트입니다

개요

설정 파일은 첫 런타임에 ~/.acemcp/settings.toml 내에서 자동으로 생성되며, 기본값을 포함합니다. - BATCH_SIZE: 배치당 업로드되는 파일 수 (기본값: 10개) - MAX_LINES_PER_BLOB: 대규모 파일 분할 전 최대 행 수 (기본값: 800) - BASE_URL: API 엔드포인트 URL - TOKEN: 인증 토큰 - TEXT_EXTENSIONS: 인덱스할 파일 확장자 목록 - EXCLUDE_PATTERNS: 제외할 모드 목록 (*.pyc와 같은 와일드카드 지원) 다음과 같이 설정할 수도 있습니다: - (최고 우선순위): --base-url、--token) - (사용자 프로필 업데이트) - (접두사 ACEMCP_ 사용) MCP 클라이언트 구성(예: Claude Desktop)에 다음 항목을 추가하세요: - --base-url: BASE_URL 설정 오버라이드 - --토큰: TOKEN 설정 오버라이드 - --web-port: 지정된 포트(예: 8080)에서 웹 관리 인터페이스를 활성화합니다 - : 서버 구성 보기와 편집 (BASE_URL, TOKEN, BATCH_SIZE, MAX_LINES_PER_BLOB, TEXT_EXTENSIONS) - : WebSocket 연결을 통한 서버 로그 실시간 모니터링, 지능형 재연결 기능 - 지수 재연결 회피 전략 (1초 → 1.5초 → 2.25초 ... 최대 30초) - 무한 루프 방지를 위한 최대 10회 재연결 시도 - 네트워크 장애 시 자동 재연결 - 로그 노이즈 감소(DEBUG 수준 WebSocket 연결 로그) - : 웹 인터페이스에서 직접 MCP 도구를 테스트 및 디버깅 - search_context 도구를 테스트하고, 프로젝트 경로와 쿼리를 입력하며, 형식화된 결과 및 오류 메시지 보기 관련 코드 맥락을 쿼리 기반 검색. 이 도구는 검색 전에 ** 작업을 수행하여 결과가 항상 최신인지 확인합니다. 코드베이스에서 ** 를 실행하며 관련 코드의 위치를 보여주는 서식화된 텍스트 조각을 반환합니다. - : 각 검색 전에 도구가 자동으로 새 파일이나 수정된 파일만 인덱싱하며, 변경되지 않은 파일은 건너뛰어 효율성을 높입니다 - : 항목을 수동으로 인덱싱할 필요는 없습니다 - 그냥 검색만 하면 도구가 자동으로 인덱스를 처리합니다 - : 검색 결과는 코드베이스의 현재 상태를 반영합니다 - : 여러 파일 인코딩(UTF-8, GBK, GB2312, Latin-1)을 자동으로 감지하고 처리함 - : 항목을 인덱싱할 때 .gitignore 모드를 자동으로 따름

개요(AI 번역)

중국어 간체 | 영어

아켐cp

코드베이스 인덱싱과 의미 검색을 위한 MCP 서버입니다.

설치

도구로서의 설치 (권장)

개발 및 설치

구성

구성 파일은 첫 실행 시 ~/.acemcp/settings.toml에서 자동으로 생성되며, 기본값을 포함합니다.

~/.acemcp/settings.toml를 편집하여 다음 사항을 설정하세요:

구성 옵션:

BATCH_SIZE: 배치당 업로드된 파일 수 (기본값: 10)
MAX_LINES_PER_BLOB: 큰 파일을 분할하기 전 최대 행 수 (기본값: 800)
BASE_URL: API 엔드포인트 URL
TOKEN: 인증 토큰
TEXT_EXTENSIONS: 인덱싱할 파일 확장자 목록
EXCLUDE_PATTERNS: 제외할 모드 목록 (*.pyc와 같은 와일드카드 지원 포함)

다음과 같은 방식으로 구성할 수도 있습니다:

명령줄 매개변수 (최고 우선순위): --base-url, --token
웹 관리 인터페이스 (사용자 프로필 업데이트)
환경 변수 (ACEMCP_ 접두사 사용)

MCP 구성

MCP 클라이언트 구성(예: Claude Desktop)에 다음 항목을 추가하세요:

기본 구성

사용 가능한 명령줄 매개변수:

--base-url: 설정 오버라이드 BASE_URL
--token: TOKEN 구성 오버라이드
--web-port: 지정된 포트(예: 8080)에서 웹 관리 인터페이스를 활성화합니다

웹 관리 인터페이스 설정 활성화

웹 관리 인터페이스를 활성화하려면 --web-port 매개변수를 추가하세요:

그 다음 관리 인터페이스에 접속합니다: http://localhost:8888

웹 관리 기능:

구성 관리: 서버 구성 (BASE_URL, TOKEN, BATCH_SIZE, MAX_LINES_PER_BLOB, TEXT_EXTENSIONS 조회 및 편집)
실시간 로그: WebSocket 연결을 통한 서버 로그의 실시간 모니터링, 지능형 재연결 기능을 특징으로 합니다
지수적 후퇴 재연결 전략 (1초 → 1.5초 → 2.25초 … 최대 30초)
무한 루프를 방지하기 위해 최대 10번의 재연결 시도
네트워크 장애 시 자동 재연결
로그 노이즈 감소 (DEBUG 수준의 WebSocket 연결 로그)
도구 디버거: 웹 인터페이스에서 직접 MCP 도구를 테스트 및 디버깅할 수 있습니다
search_context 도구를 테스트하여 프로젝트 경로와 쿼리를 입력합니다
서식화된 결과 및 오류 메시지 보기

도구

search_context

관련 코드 맥락을 쿼리 기반 검색. 이 도구는 검색 전에 자동으로 점진적 인덱싱을 수행하여 결과가 항상 최신 상태로 유지되도록 합니다.

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

설치

uvx acemcp

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

설정

{
  "mcpServers": {
    "acemcp": {
      "command": "uvx",
      "args": [
        "acemcp"
      ]
    }
  }
}