suspec-mcp

Suspec의 결정적 검사기에 셸 없이 접근하기 위한 얇은 MCP stdio 어댑터입니다. 얇음이 특징입니다. 검사 계약 0.26.0을 요구하며, 모든 CLI JSON 페이로드를 검증하고 순서가 있는 보고서와 종료 상태를 보존합니다.

도구

suspec_check

절대 아티팩트 경로의 순서가 있는 비어 있지 않은 배열에 대해 하나의 CLI 프로세스를 실행합니다. Frontmatter type:이 동작을 선택합니다.

스펙, 작업, 변경 계획 및 캠페인 입력은 CLI 검사를 받습니다. 인벤토리, 감사, 리서치 및 패널은 checked: false를 반환합니다. 누락되거나 알 수 없는 유형은 거부됩니다.

한 번의 호출은 C002와 같은 파일 간 검사를 보존합니다. 작업 경로는 하나의 specPath를 공유합니다. 모든 작업은 해당 스펙을 명명해야 합니다. 잘못된 동반 페어링은 ok: false와 함께 CLI의 구조화된 거부를 생성합니다.

모든 아티팩트 결과는 해당 유형을 반복합니다. 선택적 최종 (file set) 보고서만 유형이 없습니다.

suspec_get_checks

간결 모드에서 계약 버전과 각 핵심 검사의 ID 및 심각도를 반환합니다. 이름을 보려면 responseFormat: "detailed"를 사용하세요. 동일한 계약은 suspec://checks에서 사용할 수 있습니다.

시작 및 리소스 읽기는 종료 코드 0에서 정확한 계약 0.26.0을 요구합니다. 리소스 실패는 리소스 콘텐츠로 오류 문서를 반환하는 대신 예외를 발생시킵니다.

Related MCP server: governed-mcp

봉투

모든 성공적인 어댑터 호출은 다음을 반환합니다:

• ok: CLI가 실행되어 유효한 페이로드를 생성했는지 여부. 진단이 깨끗한지 여부는 아님.

• source: 정확한 명령과 종료 코드.

• data: 검증된 상세 출력 또는 간결한 프로젝션.

• 선택적 note.

• responseFormat.

ok는 어댑터가 작동했음을 의미하며, 아티팩트가 좋다는 의미가 아닙니다. 차단 진단이 있는 검사는 ok: true로 유지됩니다. data.level, 진단 및 source.exitCode를 검사하세요.

CLI 종료 코드 0, 1, 2는 계약에 속합니다. 다른 종료는 어댑터 시작 실패입니다. JSON 형태의 stdout은 새 계약을 협상하지 않습니다. 구조화된 CLI 오류는 종료 코드 2에서만 허용됩니다.

설치

Node.js 22.6 이상과 suspec CLI가 필요합니다. 두 패키지 모두 게시되지 않았습니다.

git clone https://github.com/jcosta33/suspec-mcp
cd suspec-mcp
corepack enable
pnpm install --frozen-lockfile

GUI 클라이언트가 셸 PATH에 의존하지 않도록 절대 진입점을 구성하세요:

{
  "mcpServers": {
    "suspec": {
      "command": "/absolute/path/to/suspec-mcp/bin/suspec-mcp.js",
      "args": ["--suspec-bin", "/absolute/path/to/suspec-cli/bin/suspec.js"]
    }
  }
}

CLI 우선순위:

각 도구 호출은 전체 아티팩트 경로를 제공합니다. 서버는 저장소, 작업 공간, 구성 또는 저장소를 바인딩하지 않습니다. 이는 어댑터이지 두 번째 제품 두뇌가 아닙니다. ~/.agents/artifacts/<workspace>/는 특별한 런타임 의미가 없습니다. 사용자 수준 정책 설치는 CLI의 작업입니다. suspec setup을 직접 실행하세요. MCP는 설정, 저장, 승격, 수명 주기 또는 오케스트레이션 표면을 노출하지 않습니다.

보안

• 기본 및 동반 경로는 절대 경로여야 하며 제어, 형식 또는 줄 구분 문자를 포함해서는 안 됩니다.

• 어댑터는 셸 없이 고정된 인자 배열을 전달합니다.

• check 및 지원되는 동반 또는 계약 플래그만 CLI에 도달합니다. setup은 하위 프로세스가 시작되기 전에 거부됩니다.

• CLI 검사 표면은 읽기 전용입니다.

서버는 프로세스에서 사용할 수 있는 모든 경로를 읽을 수 있습니다. 파일 시스템 권한은 제안이 아니라 보안 경계입니다. 프로세스 권한을 클라이언트 신뢰 경계에 맞추거나 OS 샌드박싱을 적용하세요.

개발

픽스처 드리프트는 실제 CLI를 사용합니다. 손으로 쓴 일치는 아무것도 증명하지 않습니다. SUSPEC_BIN을 절대 CLI 소스 경로로 설정하세요. 그렇지 않으면 suspec-cli라는 형제 패키지가 검색을 충족할 수 있습니다. 생성은 다른 패키지를 거부합니다.

export SUSPEC_BIN=/absolute/path/to/suspec-cli/bin/suspec.js
pnpm install
pnpm test:run
pnpm gate
pnpm fixtures

test/fixtures/provenance.json은 CLI git HEAD, 완전한 더티 작업 트리 해시 및 바이너리 해시를 기록합니다. scripts/generate-fixtures.mjs는 출력을 캡처합니다. 테스트는 모든 픽스처를 src/suspec/contract.ts를 통해 파싱합니다. 픽스처는 생성되며 손으로 편집되지 않습니다.

라이선스

MIT