ENTIA MCP 서버

AI 에이전트를 위한 구조화된 비즈니스 인텔리전스.

ENTIA는 34개국에 걸친 검증된 기업 데이터를 제공하며, Model Context Protocol (MCP) 또는 REST API를 통해 액세스할 수 있습니다.

빠른 시작 (2분 미만)

옵션 1: 원격 MCP 서버 (권장)

설치가 필요 없습니다. MCP 클라이언트를 직접 연결하세요:

Claude Desktop — claude_desktop_config.json에 추가:

{
 "mcpServers": {
 "entia": {
 "command": "npx",
 "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
 }
 }
}

Cursor IDE — .cursor/mcp.json에 추가:

{
 "mcpServers": {
 "entia": {
 "command": "npx",
 "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
 }
 }
}

그런 다음 시도해 보세요:

Look up Telefonica in Spain

옵션 2: REST API

# Search entities
curl "https://entia.systems/v1/search?q=telefonica&country=ES&limit=5" \
 -H "X-ENTIA-Key: YOUR_API_KEY"

# Full entity profile (BORME + GLEIF + VIES + Wikidata)
curl "https://entia.systems/v1/profile/Telefonica?country=ES"

# EU VAT verification
curl "https://entia.systems/v1/verify/vat/ESA28015865"

# Platform stats
curl "https://entia.systems/v1/stats"

옵션 3: Python SDK (출시 예정)

Python 클라이언트(entia-mcp on PyPI) 및 LangChain 통합이 로드맵에 있습니다. 아직 게시되지 않았습니다. 그때까지는 옵션 1(MCP) 또는 옵션 2(REST)를 사용하세요.

Related MCP server: Bizfile MCP

6가지 MCP 도구

요금제

API 키 발급: entia.systems/mcp-setup

데이터 소스

모든 데이터는 공식 공공 등록부에서 제공됩니다:

• BORME -- 스페인 상업 등기소 (BOE)

• VIES -- EU VAT 검증 (유럽 위원회)

• GLEIF -- 법인 식별자 (Global LEI Foundation)

• Wikidata -- 지식 그래프 (Wikimedia Foundation)

• REPS -- 스페인 의료 전문가 등록부

• INE -- 스페인 국립 통계청

• SEPE -- 스페인 고용 서비스

• AEAT -- 스페인 국세청

• Companies House -- 영국 기업 등록부

• Sirene/INSEE -- 프랑스 기업 등록부

링크

• API 문서

• API 키 발급

• 설정 가이드

• 클라이언트 대시보드

• 공식 MCP 레지스트리

정보

PrecisionAI Marketing OU (에스토니아, EU)에서 제작.

• VAT: EE102780516

• DUNS: 565868914

• e-Residency 인증

• eIDAS 준수

라이선스

독점. 서비스 약관을 참조하세요.

AWS 배포 (긴급 마이그레이션 런북)

이 저장소에는 infra/aws/ 하위에 ECR + ECS Fargate + ALB + Route 53 + ACM + Secrets Manager + CloudWatch Logs 환경에서 독립형 MCP 서버를 실행하기 위한 최소한의 AWS 부트스트랩이 포함되어 있습니다.

배포 내용

• 컨테이너 이미지를 위한 ECR 저장소.

• ECS 클러스터, 작업 정의 및 Fargate 서비스.

• ALB 구성:

  • 80 포트에서 443으로 리다이렉트

  • 443 포트 HTTPS 리스너 (ACM 인증서)

  • /health 경로에 대한 대상 그룹 상태 확인

• 보안 그룹 (ALB 퍼블릭 인그레스, ALB에서만 ECS로 인그레스 허용).

• mcp.entia.systems를 위한 Route53 별칭 레코드 (선택 사항).

• ECS 로그를 위한 CloudWatch Logs 그룹.

• 최소 권한 원칙을 적용한 IAM 역할 및 선택적 Secrets Manager 액세스.

유지되는 런타임 가정

• MCP_TRANSPORT=http

• MCP_PORT=3000

• 상태 확인 엔드포인트 경로: /health

필수 AWS 환경 변수 (GitHub Actions 저장소 변수)

• AWS_REGION

• ECR_REPOSITORY (예: 123456789012.dkr.ecr.us-east-1.amazonaws.com/entia-mcp-prod-mcp)

• ECS_CLUSTER

• ECS_SERVICE

• DOCKERFILE_PATH (선택 사항, 기본값 Dockerfile)

필수 GitHub Actions 시크릿

• AWS_GITHUB_ACTIONS_ROLE_ARN (Terraform/ECR/ECS 권한이 있는 OIDC 역할 ARN)

• TF_VARS_JSON_B64 (필수 Terraform 입력을 위한 base64 인코딩 JSON tfvars, container_image 제외)

필수 런타임 시크릿 (AWS Secrets Manager)

Terraform에서 secret_arns 맵(ENV_VAR_NAME => secret ARN)으로 구성하세요. 예:

• ENTIA_API_KEY

• 독립형 MCP 서버에서 사용하는 업스트림 API 자격 증명

• 런타임에서 사용하는 SMTP 또는 공급자 토큰

모든 자격 증명은 Secrets Manager에 보관하세요. 워크플로우 파일이나 Terraform 변수에 시크릿을 하드코딩하지 마세요.

배포 단계

1. infra/aws/terraform.tfvars.example을 infra/aws/terraform.tfvars로 복사합니다.

2. 네트워크/DNS/인증서/이미지 값을 채웁니다.

3. 실행:

   • terraform -chdir=infra/aws init

   • terraform -chdir=infra/aws plan

   • terraform -chdir=infra/aws apply

4. CI 배포의 경우, TF_VARS_JSON_B64 시크릿(tfvars JSON의 base64)을 제공하고 AWS MCP Deploy 워크플로우를 트리거합니다.

5. main 브랜치에 푸시하거나 GitHub Actions 워크플로우 AWS MCP Deploy를 트리거합니다.

6. 스모크 테스트 검증:

   • GET https://mcp.entia.systems/health가 200을 반환하는지 확인

   • ALB를 통해 MCP 엔드포인트에 도달 가능한지 확인

   • ECS 서비스의 대상이 정상 상태인지 확인

롤아웃 단계 (프로덕션 안전)

1. DNS를 변경하지 않고(create_dns_record=false) 인프라와 ECS 서비스를 배포한 후 ALB DNS 이름으로 테스트합니다.

2. ALB 호스트 이름에서 스모크 테스트를 실행합니다.

3. 정상 확인 후 DNS 별칭(create_dns_record=true)을 활성화합니다.

4. 최소 한 번의 전체 비즈니스 주기 동안 CloudWatch Logs 및 ALB 대상 상태를 모니터링합니다.

롤백 단계

1. DNS 별칭을 이전 서비스 엔드포인트(mcp.entia.systems)로 되돌립니다.

2. 이전 안정적인 이미지 태그 또는 ECS의 이전 작업 정의 리비전으로 재배포합니다:

   • aws ecs update-service --cluster <cluster> --service <service> --task-definition <family:revision> --force-new-deployment

3. 필요한 경우 Terraform을 이전 커밋으로 롤백하고 적용합니다.

4. /health 및 MCP 엔드포인트 복구를 확인합니다.

mcp.entia.systems DNS 전환 단계

1. 배포 리전에서 mcp.entia.systems에 대한 ACM 인증서가 발급되었는지 확인합니다.

2. create_dns_record=true, hosted_zone_id, domain_name="mcp.entia.systems"를 사용하여 Terraform을 적용합니다.

3. Route53 별칭이 ALB를 가리키고 대상 그룹이 정상인지 확인합니다.

4. 전환 후 확인 작업 실행:

   • TLS 인증서 체인 유효성 확인

   • /health = 200 확인

   • MCP 요청/응답 경로가 전체적으로 작동하는지 확인

추가적인 안전/롤백 세부 정보는 AGENTS.md 및 docs/aws-migration-assumptions.md를 참조하세요.

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers

Tools

• borme_lookupA
• entity_lookupA
• get_competitorsA
• search_entitiesA
• verify_vatA
• zone_profileA