mcpnew

기본 보안이 적용된 MCP 서버 스캐폴딩 — TypeScript 또는 JavaScript, deny-all 권한, 타입이 지정된 도구 스텁, 감사 훅이 사전 연결된 상태로 제공됩니다.

문제

수제 MCP 서버는 모두 같은 방식으로 시작됩니다. 문서에서 데모를 복사하고, 도구를 등록하면서 진행하고, "잠깐, 그 도구가 내 홈 디렉터리를 읽을 수 있나?"라고 묻는 사람이 없기를 바랍니다. 권한은 우연히 allow-all이 됩니다. 감사 로깅은 TODO로 남습니다. 입력 스키마는 핸들러에서 벗어납니다.

mcpnew는 기본값을 반전시킵니다. 서버가 노출하는 모든 기능은 거부(deny) 상태로 시작하며, 모든 도구 호출은 감사 훅을 통과하고, 모든 도구 스텁은 스키마 수준에서 한 번만 타입을 지정합니다.

Related MCP server: MCP Server Templates

설치

npm install -g mcpnewcli

런타임 의존성 없음. Node 18+.

30초 퀵스타트

# 1. Scaffold (JavaScript default; add --lang ts for TypeScript)
mcpnew create my-server && cd my-server && npm install

# 2. Add a typed tool stub — it lands DENIED in mcp.permissions.json
npx mcpnewcli add-tool search-files

# 3. Review, implement, then explicitly allow:
#    "tools": { "search-files": "allow" }

# 4. Keep yourself honest
npx mcpnewcli audit

그게 전부입니다. mcpnew audit는 매니페스트가 deny-all이 아니거나, 등록된 도구에 requireAllowed() 게이트가 없거나, 감사 훅이 연결되지 않은 경우 0이 아닌 종료 코드를 반환합니다. CI에 연결하면 구조적으로 보안을 유지할 수 있습니다.

CI에 연결하기

이 내용을 스캐폴딩된 서버 저장소(.github/workflows/audit.yml)에 넣으세요:

name: mcp-security-audit
on: [push, pull_request]
jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx --yes mcpnewcli audit

기본값 완화, 게이트 없는 도구, 연결되지 않은 훅 등 어떤 발견 사항이든 0이 아닌 종료 코드로 반환되어 병합 전에 검사를 실패시킵니다.

제공되는 것

my-server/
├── src/server.js          # MCP server: typed tool stubs + permission gates + audit hooks
├── src/audit.js           # JSONL audit trail → logs/audit.jsonl (gitignored)
├── src/manifest.js        # manifest loader (+ TS types on --lang ts)
├── test/server.test.js    # tests asserting the deny-all posture holds
└── mcp.permissions.json   # deny-all permission manifest — the source of truth

• deny-all 권한 — 도구, 리소스, 프롬프트, 네트워크, 파일시스템: 모든 것이 기본적으로 deny입니다. 와일드카드는 완전히 거부됩니다.

• 타입이 지정된 도구 스텁 — mcpnew add-tool <name>은 게이트와 감사 훅을 통해 연결된 zod 스키마 스텁을 삽입합니다. 본문만 작성하면 되고 스캐폴딩은 이미 올바릅니다.

• 사전 연결된 감사 훅 — 모든 호출은 타임스탬프, 도구, 인자, 결과, 지속 시간을 logs/audit.jsonl에 기록합니다.

구성

생성된 mcp.permissions.json:

{
  "version": 1,
  "default": "deny",
  "tools": { "ping": "deny" },
  "resources": { "default": "deny" },
  "prompts": { "default": "deny" },
  "network": { "default": "deny", "allowlist": [] },
  "filesystem": { "default": "deny", "paths": [] }
}

도구가 수행하는 작업을 읽은 후 항목을 의도적으로 하나씩 "allow"로 전환하세요. mcpnew audit는 의도한 것보다 더 많이 완화하지 않았는지 확인합니다.

Pro

프로덕션 팀에 MCP 서버를 배포하시나요? mcpnew Pro($9/월)는 정책-as-코드 검토 워크플로를 추가합니다: deny가 allow로 전환되기 전에 필수 승인을 요구하는 권한 매니페스트의 풀 리퀘스트 diff, 조직 전체 감사 로그 전송(Splunk/Datadog/Loki), 각 도구 권한을 승인 기록에 매핑하는 규정 준수 보고서. 단일 티어, 좌석 수 계산 없음. Gumroad를 통한 라이선스 — 링크 자리 표시자.

라이선스

MIT

stealth-alpha 툴킷의 일부 — 릴리스 자동화, 에이전트 보안, 저장소 위생을 위한 8개의 제로 의존성 CLI.