Nomos - Deterministic Git & AST Governance for AI Coding Agents

Live GitHub repo AST X-Ray, 42 coding-agent DoD gates, Git worktree guards & brownfield baselines.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
93%
이름 품질
86%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,665토큰 (도구 정의)
~3.1 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.08%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "nomos": {
      "command": "npx",
      "args": [
        "@mgantlett/nomos"
      ]
    }
  }
}

실행 가능한 패키지

npm@mgantlett/nomos4.30.0stdio
pypinomos-cli4.30.0stdio

원격 엔드포인트

https://sophialabs.ca/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (7)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢search_nomos_corpus(query, section)

Search Nomos Engineering Handbook chapters, Empirical Field Dispatches, Open-Core Architecture Specs, and CLI reference by keyword. Example: query='worktree isolation', section='handbook' finds chapters on Git worktrees. Use when looking up conceptual architecture, empirical benchmarks, or CLI flags. Do NOT use when inspecting a specific G-* gate or ERR_* code (use inspect_dod_gates or diagnose_nomos_error instead) or comparing external tools (use compare_governance_approaches instead).

입력 스키마

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords or engineering problem phrase to search across the public Nomos corpus.",
      "minLength": 2,
      "maxLength": 160,
      "examples": [
        "worktree isolation",
        "mutation testing",
        "CapBAC IFC"
      ]
    },
    "section": {
      "type": "string",
      "description": "Corpus subset filter (defaults to all).",
      "enum": [
        "all",
        "handbook",
        "dispatches",
        "specs",
        "cli"
      ],
      "default": "all"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "query": "worktree isolation",
      "section": "handbook"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "query": {
      "type": "string",
      "description": "Normalized search query."
    },
    "matchCount": {
      "type": "integer",
      "description": "Number of top corpus matches returned."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "query",
    "matchCount"
  ]
}
🟢inspect_dod_gates(gate_id, law, category)

List and filter the 42 compiled Go and Tree-sitter AST Definition of Done quality gates, 7 Canonical Laws, and sandbox rules. Example: gate_id='G-16' or law=7 returns matching gate invariants. Use when browsing gate invariants by G-* ID, Law 1..7, or category. Do NOT use when troubleshooting a raw verify error log or ERR_* failure (use diagnose_nomos_error instead).

입력 스키마

{
  "type": "object",
  "properties": {
    "gate_id": {
      "type": "string",
      "description": "Optional gate identifier such as G-01 or G-16.",
      "minLength": 2,
      "maxLength": 16,
      "examples": [
        "G-01",
        "G-16"
      ]
    },
    "law": {
      "type": "integer",
      "description": "Optional Canonical Law number from 1 through 7.",
      "minimum": 1,
      "maximum": 7,
      "examples": [
        2,
        3,
        7
      ]
    },
    "category": {
      "type": "string",
      "description": "Optional gate category filter.",
      "enum": [
        "ast",
        "phase",
        "sandbox",
        "security",
        "testing"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "gate_id": "G-16"
    },
    {
      "law": 2,
      "category": "ast"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "totalGates": {
      "type": "integer",
      "description": "Total compiled quality gates in Nomos."
    },
    "matchedCount": {
      "type": "integer",
      "description": "Number of gates matching the filter."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "totalGates",
    "matchedCount"
  ]
}
🟢recommend_adoption_plan(languages, repo_loc, ci_provider, airgapped)

Retrieve a read-only 4-step Nomos rollout guide (X-Ray baseline, stealth Branch Guard, CI SARIF, and isolated Git worktrees) tailored to repository LOC, languages, and air-gap constraints. Example: languages=['go','typescript'], repo_loc=120000 returns a phased brownfield guide. Use when planning rollout steps for a team or monorepo. Do NOT use when previewing raw nomos.yaml and CI workflow templates (use scaffold_nomos_config instead).

입력 스키마

{
  "type": "object",
  "properties": {
    "languages": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Programming language slug.",
        "minLength": 1,
        "maxLength": 32
      },
      "maxItems": 12,
      "description": "Primary programming languages in the repository.",
      "examples": [
        [
          "go",
          "typescript",
          "python"
        ]
      ]
    },
    "repo_loc": {
      "type": "integer",
      "description": "Approximate repository lines of code.",
      "minimum": 0,
      "maximum": 50000000,
      "default": 50000,
      "examples": [
        50000,
        250000
      ]
    },
    "ci_provider": {
      "type": "string",
      "description": "Target CI pipeline platform.",
      "enum": [
        "github",
        "gitlab",
        "other"
      ],
      "default": "github"
    },
    "airgapped": {
      "type": "boolean",
      "default": false,
      "description": "Set true for zero-egress air-gapped local GPU environments."
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "languages": [
        "go",
        "typescript"
      ],
      "repo_loc": 120000,
      "ci_provider": "github"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "airgapped": {
      "type": "boolean",
      "description": "Whether air-gapped silicon guidance was included."
    },
    "stepCount": {
      "type": "integer",
      "description": "Number of progressive rollout stages."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "airgapped",
    "stepCount"
  ]
}
🟢compare_governance_approaches(focus)

Compare Nomos deterministically against pre-commit hooks, SonarQube, ESLint, PR review bots (CodeRabbit, Greptile), prompt wrappers, and static CLAUDE.md / AGENTS.md / .cursorrules files. Example: focus='SonarQube' returns side-by-side trade-offs. Use when evaluating tool trade-offs or answering 'how is Nomos different from X'. Do NOT use when searching general Handbook tutorials (use search_nomos_corpus instead).

입력 스키마

{
  "type": "object",
  "properties": {
    "focus": {
      "type": "string",
      "description": "Optional comparison dimension or tool name filter.",
      "minLength": 2,
      "maxLength": 80,
      "examples": [
        "SonarQube",
        "pre-commit",
        "test-tampering",
        "brownfield"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "focus": "SonarQube"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "dimensionCount": {
      "type": "integer",
      "description": "Number of comparison dimensions returned."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "dimensionCount"
  ]
}
🟢xray_github_repo(repo)

Inspect a public GitHub repository via read-only static Tree-sitter AST analysis (<= 100MB source archive, strictly read-only) to retrieve its AI Hangover Score (0-100), complexity hotspots, and Day-0 baseline preview. Example: repo='go-chi/chi' returns the AST scorecard for go-chi/chi. Use when auditing a public GitHub owner/repo URL. Do NOT use when checking private repositories (private codebases require local CLI inspection via @mgantlett/nomos).

입력 스키마

{
  "type": "object",
  "properties": {
    "repo": {
      "type": "string",
      "description": "Public GitHub owner/repo slug or full https://github.com/<owner>/<repo> URL.",
      "minLength": 3,
      "maxLength": 200,
      "examples": [
        "go-chi/chi",
        "spf13/cobra",
        "mgantlett/nomos"
      ]
    }
  },
  "required": [
    "repo"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "repo": "go-chi/chi"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown response summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical documentation or twin URL for citation."
    },
    "repo": {
      "type": "string",
      "description": "Normalized owner/repo slug."
    },
    "hangoverScore": {
      "type": "integer",
      "description": "Composite 0-100 AI Hangover structural debt score."
    },
    "grade": {
      "type": "string",
      "description": "Structural health grade."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "repo"
  ]
}
🟢diagnose_nomos_error(error_code, error_log)

Look up any Nomos ERR_* failure code, TC-AGT-* vector, or nomos verify gate rejection to retrieve its root cause and non-bypassing AST remediation. Example: error_code='ERR_CROSS_PLANE_MUTATION' returns the remediation guide. Use when troubleshooting a verify failure or pre-commit hook error. Do NOT use when browsing the full catalog of 42 gates by Law or category without an error (use inspect_dod_gates instead).

입력 스키마

{
  "type": "object",
  "properties": {
    "error_code": {
      "type": "string",
      "minLength": 3,
      "maxLength": 80,
      "description": "Optional ERR_* identifier such as ERR_CROSS_PLANE_MUTATION or ERR_COGNITIVE_DEBT.",
      "examples": [
        "ERR_CROSS_PLANE_MUTATION",
        "ERR_COGNITIVE_DEBT",
        "ERR_TRIVIAL_PASS_SHIM"
      ]
    },
    "error_log": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "Optional raw error message, gate name, or pre-commit output snippet.",
      "examples": [
        "AntiShimGate: hollow TODO stub",
        "PlaneSeparationGate"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "error_code": "ERR_CROSS_PLANE_MUTATION"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown remediation summary."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical gate reference URL."
    },
    "query": {
      "type": "string",
      "description": "Combined error query string."
    },
    "matchedCodes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Matched ERR_* diagnostics."
    },
    "matchedGates": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Related compiled gates."
    },
    "docsUrl": {
      "type": "string",
      "description": "Gate catalog documentation URL."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "query",
    "matchedCodes",
    "matchedGates",
    "docsUrl"
  ]
}
🟢scaffold_nomos_config(project_name, languages, mode, ci_provider)

Preview read-only nomos.yaml configuration text, 4-line GitHub Actions SARIF workflow text, and Day-0 onboarding commands without modifying files. Example: project_name='payments-api', mode='local' returns template text. Use when retrieving ready-to-paste YAML config and CI workflow templates. Do NOT use when requesting a strategic rollout recommendation by LOC or air-gap posture (use recommend_adoption_plan instead).

입력 스키마

{
  "type": "object",
  "properties": {
    "project_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 48,
      "default": "my-service",
      "description": "Repository or project slug.",
      "examples": [
        "payments-api",
        "core-monorepo"
      ]
    },
    "languages": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 32
      },
      "maxItems": 12,
      "description": "Target languages in the repository.",
      "examples": [
        [
          "typescript",
          "go",
          "python"
        ]
      ]
    },
    "mode": {
      "type": "string",
      "enum": [
        "branch",
        "local",
        "worktrees"
      ],
      "default": "branch",
      "description": "Onboarding mode: branch (default), local (stealth .git/info/exclude), or worktrees."
    },
    "ci_provider": {
      "type": "string",
      "enum": [
        "github",
        "gitlab"
      ],
      "default": "github",
      "description": "CI platform for verification workflow output (defaults to github)."
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "project_name": "payments-api",
      "languages": [
        "go",
        "typescript"
      ],
      "mode": "local"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Deterministic Markdown configuration bundle."
    },
    "canonicalUrl": {
      "type": "string",
      "description": "Canonical quickstart URL."
    },
    "project": {
      "type": "string",
      "description": "Sanitized project slug."
    },
    "mode": {
      "type": "string",
      "description": "Selected isolation mode."
    },
    "ciProvider": {
      "type": "string",
      "description": "Selected CI provider."
    },
    "nomosYaml": {
      "type": "string",
      "description": "Generated nomos.yaml template."
    },
    "ciWorkflowYaml": {
      "type": "string",
      "description": "Generated CI pipeline YAML."
    },
    "dayZeroCommands": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Day-0 CLI bootstrap commands."
    }
  },
  "required": [
    "summary",
    "canonicalUrl",
    "project",
    "mode",
    "ciProvider",
    "nomosYaml",
    "ciWorkflowYaml",
    "dayZeroCommands"
  ]
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 7개