Symbols MCP

언어 서버에 연결하여 코드베이스 심볼을 읽고, 검사하고, 탐색합니다.

소개

이 MCP 서버는 선택한 언어 서버에 연결하여 코딩 에이전트가 코드베이스와 그 의존성을 쉽고 효율적으로 탐색할 수 있도록 합니다. 이 서버는 사용하기 간편하고 모델의 컨텍스트를 적게 차지하도록 설계된 최소한의 도구, 리소스 및 기술 세트를 제공합니다.

도구

• outline: 파일 내 코드 심볼의 개요를 반환하며, 선택적으로 작은 코드 스니펫을 포함합니다.

• inspect: 타사 심볼을 포함하여 심볼에 대한 문서, 선언 및 구현 위치를 반환합니다.

• search: 코드베이스 전체에서 일치하는 심볼을 반환합니다.

• references: 코드베이스 전체에서 심볼의 모든 참조를 찾습니다.

• call_hierarchy: 호출 가능한 심볼에 대한 수신 및 발신 호출 관계를 반환합니다.

• rename: 코드베이스 전체에서 심볼의 모든 참조 이름을 변경합니다.

• diagnostics: 주어진 파일의 활성 진단 정보를 반환합니다.

• completion: 주어진 위치에서 문맥에 맞는 자동 완성을 반환합니다.

• reload: 유효한 설정을 다시 로드하고 현재 실행 중인 언어 서버에 다시 적용합니다.

리소스

• language-servers://profiles: 구성된 언어 서버와 해당 상태를 반환합니다.

• language-servers://profiles/{name}: 특정 언어 서버에 대한 더 자세한 정보를 반환합니다.

• language-servers://profiles/{name}/logs: 문제 해결을 위한 언어 서버 로그를 반환합니다.

기술

• install-language-server: 현재 작업 공간에 대한 언어 서버 프로필을 설치, 구성, 검증 또는 문제 해결합니다.

• language-server-navigation: 텍스트 검색으로 넘어가기 전에 언어 서버 도구를 통해 심볼 검사, 참조, 이름 변경, 진단 및 검색을 안내합니다.

Related MCP server: Serena

설치

에이전트 설치

MCP 서버와 플러그인 및 확장 기능을 통한 에이전트 기술을 설치한 다음, 에이전트에게 코드베이스에 적합한 언어 서버를 설치하도록 요청하십시오.

• 확장 기능 추가: gemini extensions install p1va/symbols

• Gemini에게 요청: Please install the language servers relevant to this codebase

• MCP 서버 추가: codex mcp add language-servers -- npx -y @p1va/symbols@latest start

• 언어 서버 기술 추가: npx skills add p1va/symbols -a codex

• Codex에게 요청: Please install the language servers relevant to this codebase

수동 설치

수동 구성 및 언어 서버 예제는 여기를 참조하십시오.

개발

• pnpm lint는 린트 위반 사항을 출력합니다.

• pnpm lint:fix는 린트 위반 사항 수정을 시도합니다.

• pnpm format은 코드베이스를 포맷합니다.

• pnpm dev는 개발 모드로 시작합니다.

• pnpm build는 린터와 빌드를 실행합니다.

• pnpm start는 빌드된 아티팩트를 시작합니다.

• pnpm test:unit은 단위 테스트를 실행합니다.

• pnpm test:integration:{language id}는 주어진 언어에 대한 통합 테스트를 실행합니다.

릴리스

• pnpm sync:skills는 .agents/skills/를 다음 위치로 미러링합니다:

  • Gemini 확장 기능을 위한 skills/

  • Codex 플러그인을 위한 plugins/symbols/skills/

• pnpm version patch는 버전을 올리고 태그를 생성합니다. 그 후:

  • pnpm sync:version은 플러그인 및 확장 기능 매니페스트를 업데이트합니다.

  • git push --follow-tags는 커밋과 태그를 푸시합니다.