customclaw-mcp

재생성하지 말고 설치하세요. CustomClaw 레지스트리를 위한 MCP 서버 — LLM 및 에이전트 코드를 위한 37개의 검증된 단일 파일 유틸리티(Retry-After를 준수하는 속도 제한기, JSON 복구, 응답 캐시, 지수 백오프 재시도, 토큰 카운터, PII 스크러버). 에이전트가 그럴듯해 보이는 120줄의 새 코드를 작성하는 대신 4개의 기본 도구 호출을 사용하게 하세요.

📖 배경: 유틸리티 기억상실 문제 — 코딩 에이전트가 왜 동일한 속도 제한기를 47번이나 다시 작성했는지에 대한 설명.

30초 설치

npx -y customclaw-mcp

해당 명령어를 MCP 클라이언트 설정(아래 스니펫 참조)에 넣으면 완료됩니다. 무료 도구는 인증 없이 설치됩니다.

기능

CustomClaw 카탈로그(37개 유틸리티, 32개 무료)를 모든 Model Context Protocol 호스트(Claude Desktop, Claude Code, Cursor, Windsurf 등 MCP를 지원하는 모든 환경)에 4개의 도구로 연결합니다:

설치 (클라이언트별)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "customclaw": {
      "command": "npx",
      "args": ["-y", "customclaw-mcp"]
    }
  }
}

Claude Desktop을 재시작하세요. 도구 선택기에 도구가 나타납니다.

Claude Code

claude mcp add customclaw -- npx -y customclaw-mcp

Cursor / Windsurf / 기타 stdio MCP 호스트

호스트를 npx -y customclaw-mcp로 지정하세요.

스트리밍 가능한 HTTP (smithery, ChatGPT 등)

호스팅된 엔드포인트 https://customclaw.company/mcp를 사용하세요. smithery에 onlythebestswfl/customclaw로 등록되어 있습니다.

예시 프롬프트

연결 후:

• "Retry-After를 준수하는 속도 제한기를 추가해 줘." → search_utilities → install_utility rate-limit-handler

• "Claude 출력에서 깨진 JSON을 파싱해야 해." → json-repair

• "LLM 응답 캐싱을 위한 도구가 있어?" → search_utilities → 짧은 결과 테이블

• "token-optimiser를 ./src/lib에 설치해 줘." → 직접 install_utility

• "이 프로젝트의 프롬프트에서 인젝션 취약점을 스캔하고 싶어 — 도구가 있을까?" → injection-scanner

작업 → 슬러그 빠른 참조

전체 목록은 list_utilities 또는 customclaw.company/api/catalog에서 확인하세요.

유료 유틸리티

유료 유틸리티의 경우, 영수증 이메일에 있는 Stripe 결제 session_id를 install_utility의 session_id 인수로 전달하세요. 그렇지 않으면 도구가 401 오류를 반환합니다.

환경 변수

• CUSTOMCLAW_BASE — 레지스트리 기본 URL 재정의 (기본값 https://customclaw.company). 스테이징 또는 자체 호스팅 미러에 유용합니다.

작동 방식

• Node.js stdio MCP 서버. 의존성: @modelcontextprotocol/sdk.

• GET /api/catalog에서 카탈로그를 가져오며, 프로세스당 5분간 캐시됩니다.

• 페이로드는 GET /api/cli?slug=<slug>[&session_id=<cs_...>]에서 가져오며, 이는 공식 customclaw-cli가 사용하는 엔드포인트와 동일합니다.

• install_utility는 target_dir 외부로의 쓰기를 거부합니다 (경로 탐색 방지).

링크

• 레지스트리: customclaw.company

• CLI 동반 도구: customclaw-cli

• 소스: github.com/onlythebestswfl-ops/customclaw-mcp

라이선스

MIT.