Enrich Layer MCP 서버

Enrich Layer API를 통해 회사, 사람, 연락처, 학교 및 직업 데이터를 보강할 수 있는 25개의 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

Claude Desktop, Claude Code, Cursor, VS Code 등 모든 MCP 호환 클라이언트와 함께 사용할 수 있습니다.

빠른 시작

npx -y @enrichlayer/mcp-server

API 키를 환경 변수로 설정하세요:

export ENRICH_LAYER_API_KEY=your_api_key_here

API 키는 enrichlayer.com/dashboard에서 받을 수 있습니다.

Related MCP server: LeadMagic MCP Server

설정

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "enrich-layer": {
      "command": "npx",
      "args": ["-y", "@enrichlayer/mcp-server"],
      "env": {
        "ENRICH_LAYER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop (MCPB 확장)

Releases에서 .mcpb 파일을 다운로드하여 Claude Desktop에서 열면 설정 중 API 키를 입력하라는 메시지가 표시됩니다.

Claude Code

claude mcp add enrich-layer -- npx -y @enrichlayer/mcp-server

그런 다음 셸에서 환경 변수 ENRICH_LAYER_API_KEY를 설정하세요.

Cursor

Cursor MCP 설정에 추가하세요:

{
  "mcpServers": {
    "enrich-layer": {
      "command": "npx",
      "args": ["-y", "@enrichlayer/mcp-server"],
      "env": {
        "ENRICH_LAYER_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code

VS Code MCP 설정(.vscode/mcp.json)에 추가하세요:

{
  "servers": {
    "enrich-layer": {
      "command": "npx",
      "args": ["-y", "@enrichlayer/mcp-server"],
      "env": {
        "ENRICH_LAYER_API_KEY": "your_api_key_here"
      }
    }
  }
}

원격 HTTP 서버

원격 배포의 경우 서버는 Streamable HTTP 전송도 지원합니다:

npm run start:http

이렇게 하면 JSON-RPC용 /mcp 엔드포인트와 상태 확인용 /health 엔드포인트가 있는 Express 서버가 포트 3000에서 시작됩니다(PORT 환경 변수로 설정 가능).

선택적 Sentry 자체 보고

서버는 SENTRY_DSN이 설정된 경우 시작, 요청 및 정상 종료 실패를 캡처합니다. 이와 함께 SENTRY_ENVIRONMENT, SENTRY_RELEASE, SENTRY_SERVICE를 설정하여 이벤트 태그를 제어할 수 있습니다. 기본값은 현재 NODE_ENV, 패키지 버전, HTTP의 경우 enrich-layer-mcp-server, stdio의 경우 enrich-layer-mcp-server-stdio입니다. 환경 변수는 항상 이러한 기본값보다 우선합니다. DSN이 없거나 잘못된 경우 서버 시작에 영향을 주지 않고 보고가 비활성화됩니다. 실패 원격 측정은 전송 전에 정리됩니다. 요청 쿼리 문자열이 제거되고, 자격 증명과 유사한 값이 수정되며, 기본 PII 및 추적 통합이 비활성화됩니다. 오류 텍스트는 정리 후에도 전달될 수 있으므로 해당 운영 원격 측정이 허용되는 경우에만 이 기능을 구성하세요.

애플리케이션은 환경 파일을 로드하지 않습니다. 배포/런타임 관리자는 이러한 변수를 내보내거나 비밀 저장소를 통해 주입해야 합니다. DSN을 소스에 커밋하거나 요청에 전달하지 마세요. 프로덕션 mcp.verticalint.co 배포의 경우 Vault 주입 및 롤아웃은 INF-887에서 별도로 추적됩니다.

사용 예시

1. 회사 조회

"Stripe의 회사 프로필을 조회해 줘"

이 명령은 enrich_company_lookup을 company_name: "Stripe"로 호출하여 회사의 전문 네트워크 URL과 프로필 데이터를 찾습니다.

2. 역할별 업무 이메일 찾기

"Notion의 CTO 업무 이메일을 찾아 줘"

이 명령은 두 도구를 연결합니다. 먼저 enrich_role_lookup을 company_name: "Notion", role: "cto"로 호출하여 사람을 찾은 다음, 해당 프로필 URL로 enrich_work_email을 호출하여 이메일 주소를 얻습니다.

3. 크레딧 잔액 확인

"남은 크레딧이 얼마나 되나요?"

이 명령은 enrich_credit_balance를 호출하여 남은 API 크레딧을 표시합니다. 크레딧이 소모되지 않습니다.

사용 가능한 도구 (25개)

회사 (7개 도구)

사람 (4개 도구)

연락처 (6개 도구)

학교 (2개 도구)

직업 (3개 도구)

검색 (2개 도구)

메타 (1개 도구)

개인정보 보호정책

Enrich Layer는 사용자가 도구 매개변수(URL, 이름, 이메일)로 명시적으로 전달한 데이터만 수집합니다. MCP 전송을 통해 대화 데이터나 채팅 기록이 수집되지 않으며, 모든 API 요청은 HTTPS를 통해 Enrich Layer API로 직접 전송됩니다. 선택적 Sentry 자체 보고가 구성된 경우, 정리된 운영 실패 원격 측정이 구성된 Sentry 프로젝트로 전송될 수 있습니다. 이는 API 요청 경로와 별개이며 SENTRY_DSN을 생략하여 비활성화할 수 있습니다.

전체 개인정보 보호정책은 enrichlayer.com/privacy에서 확인하세요.

개발

# Install dependencies
npm install

# Build
npm run build

# Run stdio server (for MCP clients)
npm start

# Run HTTP server (for remote deployments)
npm run start:http

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

API 표면 적합성

도구 스키마는 게시된 Enrich Layer OpenAPI 사양을 따릅니다. 이는 API 표면의 단일 진실 공급원입니다: https://enrichlayer.com/docs/api/v2/openapi.yaml

사양의 사본은 spec/enrichlayer-api.yaml에 벤더링되어 있으며, CI는 모든 풀 리퀘스트에서 npm run check:spec을 실행합니다. 다음의 경우 도구가 검사에 실패합니다:

• 해당 엔드포인트가 사양에 없는 경우;

• 해당 엔드포인트에 대해 사양에 문서화되지 않은 매개변수를 노출하는 경우;

• 매개변수의 필수/선택 플래그가 사양과 일치하지 않는 경우;

• 사양에서 필수로 표시된 매개변수를 생략한 경우.

도구가 노출하지 않는 선택적 사양 매개변수는 경고로 보고됩니다. 도구는 의도적으로 선별된 하위 집합을 노출할 수 있습니다. 검사는 매개변수 이름과 필수 여부만 확인합니다. 열거형 값이나 유형은 검증하지 않습니다. 사양이 쿼리 매개변수에 대해 이를 인코딩하지 않기 때문입니다.

API가 변경될 때:

npm run update-spec    # refresh spec/enrichlayer-api.yaml from the published URL
npm run build
npm run check:spec     # see which tools drifted, fix their schemas

적합성 로직은 scripts/conformance-core.mjs에 있으며 단위 테스트됩니다(npm test, Node 내장 테스트 러너).

라이선스

MIT