MCQuest MCP — 읽기 전용 프로젝트 인텔리전스 서버

AI 코딩 에이전트가 소프트웨어 프로젝트의 소스 코드와 아키텍처에 구조적으로 접근할 수 있게 해주는 재사용 가능한 읽기 전용 MCP 서버입니다.

원래 MCQuest를 위해 개발되었으며, 애플리케이션 저장소 외부에서 독립형 개발자 도구로 유지 관리됩니다.

다른 프로젝트에서도 재사용할 수 있습니다.

기능

현재 버전(v0.2)은 범주별로 구성된 16개의 읽기 전용 도구를 제공합니다.

프로젝트 구조

소스 코드 분석

문서 인텔리전스

교차 근거 및 Git

이 서버는 대상 프로젝트를 수정하지 않습니다.

Related MCP server: reflens

문서 인식

문서 도구는 AI 에이전트에게 프로젝트 Markdown 문서(예: docs/, memory-bank/)에 대한 읽기 전용 액세스를 제공하며, 이전 감사 및 구현 단계도 포함됩니다.

• mcquest_list_docs — 프로젝트 상대 경로 아래의 Markdown 파일을 나열합니다.

• mcquest_read_doc — 정확한 줄 번호와 함께 Markdown 파일을 읽습니다.

• mcquest_search_docs — Markdown 문서 전체를 정규식/텍스트로 검색하고 파일 경로, 줄 번호, 일치하는 줄과 주변 맥락을 반환합니다.

• mcquest_phase_context — 두 가지 모드: query 모드(자유 텍스트: "responsive overflow", "Android")와 phase 모드(구조적 검색: phase="61")가 있습니다. phase 모드는 문서 유형별로 그룹화된 결과를 반환합니다.

이 도구들은 원본 Markdown 근거와 줄 참조를 보존합니다. 문서를 요약하거나 재작성하거나 해석하지 않으며, AI 에이전트가 스스로 판단할 수 있도록 원본 근거를 그대로 반환합니다.

이 도구들은 원본 텍스트와 줄 참조를 유지함으로써 문서화된 사실, 완료된 작업, 감사 결과, 권장 사항, 미해결 이슈, 그리고 명시적으로 검증되지 않은/정적 확인 결과를 구분합니다. 검증되지 않았거나 정적 확인 결과를 검증된 사실로 바꾸지 않습니다.

안전성

이 MCP는 의도적으로 읽기 전용입니다.

다음을 제공하지 않습니다:

• 파일 편집

• 파일 생성

• 파일 삭제

• 셸 실행

• 임의 코드 실행

• 패키지 설치

• Git 변경

• 커밋

• 푸시

• 배포

이 서버는 근거를 제공하도록 설계되었으며, AI 코딩 에이전트가 추론을 수행합니다.

권장 Cline 사용 흐름

1. mcquest_project_context — 프로젝트 방향 파악을 위한 첫 번째 호출

2. mcquest_phase_context(phase="N") — 특정 단계 이해

3. mcquest_find_evidence(query="...") — 코드와 문서 교차 검색

4. mcquest_read_file / mcquest_read_doc — 특정 파일 읽기

5. mcquest_git_context — 조사 전 최근 변경 사항 확인

6. mcquest_compare_phase(from_phase="61", to_phase="62") — 단계 비교

버전 이력

• v0.2.0 — project_context, find_evidence, git_context, compare_phase 추가. 모든 도구 설명 개선. phase_context에 문서 유형별로 그룹화된 구조화 검색을 위한 phase 매개변수 추가.

• v0.1.0 — 읽기 전용 도구 12개로 최초 출시.

요구 사항

• Windows, macOS, Linux

• Python 3.10+

• uv

• MCP Python SDK

• MCP Inspector를 사용할 때만 Node.js

설치

애플리케이션 저장소 외부에 서버를 복제하거나 배치하십시오.

예시:

D:\DeveloperTools\mcquest-mcp