@m00nsolutions/mcp-server

MCP를 통한 에이전틱 테스트 관리입니다. 이 서버는 AI 어시스턴트가 무언가를 읽는 데 그치지 않고 실제 작업을 수행할 수 있게 합니다. 테스트 케이스를 작성하고, 수동 테스트 실행을 계획하고 채우고, 자동화를 해당 자동화가 다루는 케이스에 연결하고, 릴리스를 만들고, AI 네이티브 테스트 관리 플랫폼인 M00N Report에서 프로젝트 상태를 확인할 수 있습니다.

어떤 설치 방식이 필요한가요?

claude.ai나 claude.com에서 연결하지 않는 경우 이 패키지를 MCP 키와 함께 사용하세요. 이 README의 나머지가 바로 그 내용입니다. 커넥터에 대해서는 커넥터 가이드를 참조하세요.

Related MCP server: @testneo/mcp-server

요구 사항

Node 20 이상과 MCP를 지원하는 클라이언트가 필요합니다.

설치

설치 단계가 없습니다. 클라이언트가 아래에 구성된 대로 npx로 실행합니다.

공용 환경이나 CI 환경에서 버전을 고정하려면 args의 패키지 이름 끝에 버전을 하나 추가하세요. 예: ["-y", "@m00nsolutions/mcp-server@<version>"]. npm view @m00nsolutions/mcp-server versions를 실행하면 게시된 버전 목록이 표시됩니다. 여기서 숫자 대신 자리표시자를 사용한 것은 의도적입니다. 구체적인 예시는 다음 릴리스에서 낡아지고, 표현식 예시는 현재 수정 사항이 더 이상 적용되지 않은 버전을 고정하도록 권장하기 때문입니다.

빠른 시작

1. MCP 키 만들기

M00N Report에서 Settings -> MCP Keys를 열고 키를 생성하세요. 키는 m00n_mcp_로 시작하며 그 뒤에 48자리 16진수가 옵니다. 테스트 리포터가 사용하는 자격 증명은 m00n_으로 시작하며 여기서는 거부됩니다.

MCP 키는 소유 계정의 권한만 정확히 가지며 그 이상을 가지지 않으며, 더 범위를 줄일 수 있습니다. 범위를 지정하면 클라이언트가 보는 도구 목록에서 도구가 제거됩니다. 따라서 예상보다 짧은 도구 목록은 오류로 설정했을 뿐입니다.

키는 사용자 머신에 있는 MCP 클라이언트 구성에 넣으세요. 저장소 안에 있는 워크스페이스 파일에는 넣지 마세요.

2. 클라이언트 연결

Claude Code는 한 줄이면 됩니다:

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

다른 모든 클라이언트는 동일한 JSON 블록을 사용합니다:

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

해당 블록을 넣을 위치:

셀프 호스팅 인스턴스의 경우 M00N_API_URL을 /api 접미사 없이 자신의 루트 오리진으로 설정하세요. 끝의 슬래시는 자동으로 제거됩니다.

3. 연결 확인

클라이언트를 다시 시작한 다음 이렇게 요청하세요:

내 M00N Report 프로젝트 목록을 보여줘

프로젝트 목록이 반환되면 서버가 연결되었고 키가 유효하다는 뜻입니다. 오류가 발생하거나 어시스턴트가 그런 도구가 없다고 하면 연결되지 않은 것입니다. 문제 해결을 참조하세요.

도구

8개 영역입니다. 인수까지 포함한 전체 목록은 코드와 함께 /documentation/mcp/tools에 있습니다. 서버는 시작할 때 인스턴스에서 자체적으로 목록을 가져오므로 클라이언트가 보는 내용은 클라이언트가 연결될 때 인스턴스가 지원하던 내용입니다.

실행(execution)은 수동 테스트 실행입니다. 담당자, 환경, 날짜, 그리고 각 케이스가 추가된 시점의 스냅샷을 기준으로 캡처된 단계별 결과가 포함됩니다.

키로 볼 수 있는 도구 수는 인스턴스가 결정합니다:

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

2026-08-22 시점에 m00nreport.com에서 범위 제한이 없는 키로 반환된 결과는 57개였습니다.

프롬프트

클라이언트가 이름으로 제안할 수 있는 단계별 워크플로우입니다. 각 프롬프트는 하나의선택적 project 인수(이름 또는 UUID)를 받습니다. 인수를 생략하면 범위에 하나의 프로젝트만 있을 때 서버가 해당 프로젝트를 선택합니다.

리소스

도구를 호출하지 않고 클라이언트가 가져올 수 있는 읽기 전용 보기: 전체 프로젝트, 프로젝트 상태 요약, 플레이키 테스트 보고서, 현재 실패 중인 테스트, 폴더 구조, 실행/시험 버전(launch) 보고서, 테스트 케이스 내용, 릴리스 요약.

구성

두 불리언은 대소문자에 관계없이 true, 1, yes 일 때 켜집니다. false, 0을 포함한 다른 모든 값은 꺼짐을 유지합니다.

첫 두 변수는 둘 다 설정하거나 둘 다 설정하지 마세요. 하나만 설정하면 오용으로 간주하고 거부합니다. 절반만 구성된 서버가 어쨌든 시작하면 시작조차 하지 않는 서버보다 진단하기 어렵기 때문입니다.

여기서 기본 URL은 M00N_API_URL입니다. 테스트 리포터는 동일한 URL을 M00N_SERVER_URL이라고 부릅니다. 여섯 개 패키지 모두 M00N_API_KEY를 읽지만, 이들은 이들의 키는 MCP 키가 아닌 프로젝트 API 키입니다. 따라서 내보낸 하나의 셸 변수로 두 시나리오 모두 처리할 수 없습니다.

키 없이 실행

M00N_API_URL도 M00N_API_KEY도 없이 시작하면 서버는 미리보기 모드로 실행됩니다. 즉, 도구, 프롬프트, 리소스를 번들된 스냅샷에서 나열하고, 설정할 내용을 알리면서 모든 호출을 거부합니다. 어떤 곳으로는 아무것도 전송되지 않습니다. 전송할 곳이 없기 때문입니다.

그 덕분에 인스펙터나 클라이언트 or디렉터리가 누구도 가입하지 않았을 때도 도구 표면을 볼 수 있습니다. 동작 중인 서버가 아닌 서버의 설명이므로 목록은 인스턴스가 아닌 스냅샷에서 가져옵니다. 범위가 조정된 키는 일반적으로 스냅샷이 표시하는 것보다 적은 도구만 볼 수 있습니다.

관리자는 범위가 조정되지 않은 키로 npm run snapshot:refresh를 실행하여 스냅샷을 새로 고칩니다.

셀프 호스팅

M00N_API_URL을 자체 인스턴스로 지정하고 해당 인스턴스에서 MCP 키를 발급받으세요. 그 외에는 동일합니다. 셀프 호스팅을 선택하는 이유가 테스트 데이터를 네트워크에서 보내도록 하기 위해서라면 이 점이 중요합니다.

자체 서명 인증서를 사용하는 경우 동일한 env 블록에 "M00N_INSECURE_SSL": "true"를 추가하세요. 전체 안내: /documentation/mcp/self-hosted.

전송되는 내용

HTTPS를 통해 M00N_API_URL로 전송되는 항목: AI 어시스턴트가 수행하는 도구 호출과 해당 인수입니다. 서버는 자체 인스턴스에 대한 프록시일 뿐이며 자체적으로 아무것도 저장하지 않습니다.

모든 도구 호출은 앱에서 UI를 제공하는 MCP 감사 로그에 기록되며 키별 속도 제한이 통제 못 하는 에이전트를 막습니다. 키는 로그에도 stderr에도 절대 기록되지 않습니다. M00N_DEBUG를 활성화하면 모든 도구 호출의 인자가 stderr로 출력되므로 그 출력도 데이터 자체처럼 취급하세요.

문제 해결

서버는 M00N_DEBUG 설정 여부와 관계없이 stderr에 로그를 남기며, 대부분의 클라이언트는 이를 MCP 패널에서 표시합니다. M00N_DEBUG를 true로 설정하면 각 요청과 인자가 로그에 추가됩니다.

알려진 제한 사항

• 도구 목록은 시작 시 한 번만 읽습니다. 키의 권한 범위를 다시 조정하거나 인스턴스를 업그레이드해도 클라이언트를 재시작하기 전까지 기존 목록이 유지됩니다.

• GET /api/health는 설정된 경우 반드시 접근 가능해야 합니다. 다른 어떤 것보다 먼저 확인되며, 실패하면 서버가 중지됩니다. 따라서 /api/mcp/*만 전달하는 프록시는 모든 도구가 정상 동작하더라도 도구가 전혀 표시되지 않습니다.

• 도구 권한이 0개인 키는 서버를 시작할 수 없습니다. 빈 목록으로 연결하는 대신 서버가 종료됩니다. 이는 자격 증명은 존재하지만 권한이 없을 때의 구성된 동작이며, 자격 증명이 전혀 없으면 미리보기 모드로 시작합니다.

• 프롬프트와 리소스는 선택 항목입니다. 목록 조회에 실패해도 서버는 계속 시작되며, 원인은 stderr에 기록됩니다. 클라이언트는 세션 내내 프롬프트와 리소스를 표시하지 않습니다.

• 리다이렉트는 따르지 않고 거부됩니다. 키는 사용자 지정 헤더에 포함되며, 리다이렉트 처리는 인식하는 인증 헤더만 제거합니다. 따라서 리다이렉트를 따라가면 키가 다음 호스트로 전달됩니다. 리다이렉트는 가리키는 주소와 함께 보고됩니다.

• stdio만 지원합니다. HTTP 전송이 필요한 경우 호스팅 커넥터를 사용하세요.

지원

• npm 패키지

• 문서

• 이슈 보고

• 커뮤니티 Discord

라이선스

MIT License. LICENSE를 참조하세요.