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 키 (선택 사항, 속도 제한 상향)

무료 티어는 클라이언트당 UTC 기준 하루 30회 검사를 허용합니다. 이를 하루 300회로 늘리려면 https://www.brandomica.com/keys 에서 키를 생성하고 BRANDOMICA_API_KEY를 통해 전달하세요:

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

키가 없어도 서버는 무료 티어에서 계속 작동합니다.

사용자 지정 API URL

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

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

필요한 경우 두 환경 변수를 결합할 수 있습니다.

Related MCP server: BrandSnap MCP

도구

모든 도구는 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단계 워크플로우를 사용합니다:

1. 빠른 위험 결정을 위한 brandomica_assess_safety (전반적인 위험 수준, 0-100 안전 점수, 차단 요소, 권장 조치)

2. 의사결정 등급의 출원 출력을 위한 brandomica_filing_readiness (판결, 관할권/분류별 주요 충돌, 증거 링크, 신뢰도 격차)

3. 더 깊은 원시 증거가 필요할 때만 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

Resources

• Remote Server
• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• brandomica_assess_safetyA
• brandomica_batch_checkA
• brandomica_brand_reportA
• brandomica_check_allA
• brandomica_check_appstoresA
• brandomica_check_domainsA
• brandomica_check_googleA
• brandomica_check_saasA