Brandomica Lab MCP 서버

brandomica-mcp-server MCP 서버 Cursor에 설치

도메인, 소셜 핸들, 상표, 앱 스토어 및 SaaS 채널 전반에 걸쳐 브랜드 이름 가용성을 확인하기 위한 MCP (Model Context Protocol) 서버입니다.

Brandomica Lab에서 제공합니다.

설치

원격 (설치 불필요)

스트리밍 가능한 HTTP를 통해 직접 연결하세요. 설치가 필요하지 않습니다:

https://www.brandomica.com/mcp

Claude Code

claude mcp add brandomica -- npx brandomica-mcp-server

Claude Desktop

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "brandomica": {
      "command": "npx",
      "args": ["brandomica-mcp-server"]
    }
  }
}

OpenClaw

OpenClaw 설정(openclaw.json)에 추가하세요:

{
  "mcpServers": {
    "brandomica": {
      "command": "npx",
      "args": ["brandomica-mcp-server"]
    }
  }
}

또는 ClaWHub에서 스킬을 설치하세요:

clawhub install brandomica

사용자 지정 API URL

로컬 개발 서버나 사용자 지정 배포를 가리키려면:

{
  "mcpServers": {
    "brandomica": {
      "command": "npx",
      "args": ["brandomica-mcp-server"],
      "env": {
        "BRANDOMICA_API_URL": "http://localhost:3000"
      }
    }
  }
}

Related MCP server: BrandSnap MCP

도구

도구	설명
`brandomica_check_all`	전체 브랜드 확인 — 도메인, 소셜, 상표, 앱 스토어, SaaS + 점수
`brandomica_assess_safety`	빠른 안전성 전용 출력 (전반적인 위험도, 0-100 안전 점수, 차단 요소, 조치 사항)
`brandomica_filing_readiness`	출원 준비 요약 (판결, 관할권/분류별 주요 충돌, 증거 링크, 신뢰도 격차)
`brandomica_compare_brands`	2-5개의 브랜드 이름을 나란히 비교 (결과는 요청 순서 유지 + 추천)
`brandomica_brand_report`	전체 브랜드 안전성 보고서 — 실사를 위한 타임스탬프가 찍힌 증거 문서
`brandomica_check_domains`	가격을 포함한 6개 TLD에 대한 도메인 가용성
`brandomica_check_social`	소셜 핸들 가용성 (GitHub, Twitter/X, TikTok, LinkedIn, Instagram)
`brandomica_check_trademarks`	상표 레지스트리 검색 (USPTO, EUIPO)
`brandomica_check_appstores`	앱 스토어 및 Google Play 검색
`brandomica_check_google`	웹 존재 여부 — Google 검색 경쟁사 중복 감지
`brandomica_check_saas`	패키지 레지스트리 및 SaaS 가용성 (npm, PyPI, crates.io, RubyGems, NuGet, Homebrew, Docker Hub, ProductHunt)
`brandomica_batch_check`	2-10개의 브랜드 이름을 한 번에 확인하고 점수순으로 정렬

모든 도구는 brand_name 매개변수(소문자, 숫자, 하이픈)를 허용합니다. brandomica_check_all, brandomica_assess_safety, brandomica_filing_readiness는 선택적 mode 매개변수(quick 또는 full)도 허용합니다. brandomica_compare_brands는 brand_names 배열(2-5개)을 허용합니다. brandomica_batch_check는 brand_names 배열(2-10개)과 선택적 mode 매개변수(quick 또는 full)를 허용합니다.

예시

1. 빠른 가용성 확인

"'acme'라는 브랜드 이름을 사용할 수 있는지 확인해줘"

Claude는 brandomica_check_all을 호출하고 0-10 가용성 점수, 0-100 안전 점수, 도메인 가격, 소셜 핸들, 상표 충돌 등이 포함된 구조화된 JSON 응답을 반환합니다.

2. 안전 우선 흐름

"먼저 'acme'의 안전성을 평가해줘. 위험도가 중간 이상이면 전체 모드로 출원 준비 상태를 실행하고 증거 링크와 함께 주요 충돌 사항을 요약해줘."

Claude는 3단계 워크플로우를 사용합니다:

빠른 위험 결정을 위한 brandomica_assess_safety (전반적인 위험 수준, 0-100 안전 점수, 차단 요소, 권장 조치)
결정 등급의 출원 출력을 위한 brandomica_filing_readiness (판결, 관할권/분류별 주요 충돌, 증거 링크, 신뢰도 격차)
더 깊은 원시 증거가 필요할 때만 brandomica_check_all 사용

3. 배치 비교

"개발자 도구를 위해 'nexlayer', 'buildkraft', 'codelaunch' 중에서 선택하려고 해. 세 가지를 모두 비교하고 가장 안전한 옵션을 추천해줘."

Claude는 세 가지 이름을 모두 사용하여 brandomica_compare_brands를 호출합니다. 각 후보는 전체 가용성 점수와 안전성 평가를 받습니다. 응답에는 요청 순서대로 결과가 포함되며, 가장 높은 점수를 받은 후보를 강조하는 추천이 포함됩니다.

자동 호출 규칙

이름 지정 세션 중에 브랜드 이름을 자동으로 확인하려면 프로젝트의 CLAUDE.md에 다음을 추가하세요:

When brainstorming or suggesting product names, brand names, or startup names, always run brandomica_assess_safety on each candidate before recommending. If any show medium or high risk, follow up with brandomica_filing_readiness.

개발

cd mcp-server
npm install
npm run build
node dist/index.js

MCP Inspector로 테스트:

npx @modelcontextprotocol/inspector node dist/index.js

문제 해결

Claude Desktop에서 "도구가 나타나지 않음"

설정 파일 경로 확인:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
JSON 구문 검증 (후행 쉼표, 누락된 따옴표)
설정 편집 후 Claude Desktop 재시작
터미널에서 npx brandomica-mcp-server가 오류 없이 실행되는지 확인

Claude Code에서 "도구가 나타나지 않음"

# Verify the server is registered
claude mcp list

# Re-add if missing
claude mcp add brandomica -- npx brandomica-mcp-server

npx가 멈추거나 시간 초과됨

npx 캐시 삭제: npx clear-npx-cache 후 재시도
대신 전역 설치: npm install -g brandomica-mcp-server 후 npx brandomica-mcp-server 대신 brandomica-mcp-server 명령 사용
네트워크 연결 확인: npm ping

도구가 오류를 반환하거나 결과가 비어 있음

속도 제한 (429): 원격 엔드포인트는 분당 30개의 요청을 허용합니다. 60초 대기 후 재시도하세요.
시간 초과: 일부 확인(도메인, 상표)은 외부 API를 호출합니다. 일시적인 오류는 재시도 시 해결됩니다.
null 소셜 핸들: null은 검색 제공자가 해당 플랫폼을 인덱싱하지 않았음을 의미하며, 핸들을 사용할 수 있거나 이미 사용 중이라는 의미가 아닙니다. true/false만 확실합니다.

원격 엔드포인트(HTTPS)가 응답하지 않음

URL 확인: https://www.brandomica.com/mcp
서비스 상태 확인: https://www.brandomica.com/status
원격 엔드포인트는 스트리밍 가능한 HTTP 전송을 사용하므로 MCP 클라이언트가 이를 지원하는지 확인하세요.

사용자 지정 API URL 사용

로컬 개발 서버나 사용자 지정 배포를 가리키도록 BRANDOMICA_API_URL을 설정하세요:

BRANDOMICA_API_URL=http://localhost:3000 npx brandomica-mcp-server

MCP Inspector로 디버깅

npx @modelcontextprotocol/inspector npx brandomica-mcp-server

각 도구를 대화형으로 호출하고 JSON 응답을 검사할 수 있는 브라우저 UI가 열립니다.

개인정보 처리방침

이 서버는 브랜드 이름 확인을 수행하기 위해 Brandomica Lab API(brandomica.com)에 연결합니다. 전체 개인정보 처리방침을 확인하세요: https://www.brandomica.com/privacy

사용자 계정이나 인증이 필요하지 않음
쿼리 데이터는 메모리에 5~30분 동안 캐시된 후 삭제됨
개인정보를 수집, 저장 또는 공유하지 않음
모든 확인은 공개 API 및 레지스트리를 사용함

지원

GitHub Issues — 버그 보고, 기능 요청
이메일: support@brandomica.com
보안 취약점: security@brandomica.com (비공개 보고서만)
보안 정책: SECURITY.md 및 /.well-known/security.txt 참조

라이선스

MIT

brandomica-mcp-server