MCP-сервер ENTIA

Структурированная бизнес-аналитика для ИИ-агентов.

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 на PyPI) и интеграция с LangChain находятся в разработке. Пока не опубликованы. До тех пор используйте Вариант 1 (MCP) или Вариант 2 (REST).

Related MCP server: Bizfile MCP

6 инструментов MCP

Тарифы

Получите ваш API-ключ: entia.systems/mcp-setup

Источники данных

Все данные поступают из официальных публичных реестров:

• BORME — Испанский торговый реестр (BOE)

• VIES — Проверка НДС в ЕС (Европейская комиссия)

• GLEIF — Идентификаторы юридических лиц (Global LEI Foundation)

• Wikidata — Граф знаний (Wikimedia Foundation)

• REPS — Испанский реестр медицинских работников

• INE — Национальный институт статистики Испании

• SEPE — Государственная служба занятости Испании

• AEAT — Налоговое управление Испании

• Companies House — Реестр компаний Великобритании

• Sirene/INSEE — Реестр компаний Франции

Ссылки

• Документация API

• Получить API-ключ

• Руководство по настройке

• Панель управления клиента

• Официальный реестр MCP

О нас

Создано PrecisionAI Marketing OU (Эстония, ЕС).

• НДС: EE102780516

• DUNS: 565868914

• Сертифицированное e-Residency

• Соответствие eIDAS

Лицензия

Проприетарная. См. Условия использования.

Развертывание в AWS (план экстренной миграции)

Этот репозиторий теперь включает минимальный AWS-бутстрап для запуска автономного MCP-сервера на базе ECR + ECS Fargate + ALB + Route 53 + ACM + Secrets Manager + CloudWatch Logs в папке infra/aws/.

Что развертывается

• Репозиторий ECR для образов контейнеров.

• Кластер ECS, определение задачи и сервис Fargate.

• ALB с:

  • перенаправлением порта 80 на 443

  • HTTPS-слушателем на порту 443 (сертификат ACM)

  • проверкой работоспособности целевой группы по пути /health

• Группы безопасности (публичный входящий трафик ALB, входящий трафик ECS только от ALB).

• Псевдоним Route53 (опционально) для mcp.entia.systems.

• Группа логов CloudWatch для логов ECS.

• Роли 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 (ARN роли OIDC с правами Terraform/ECR/ECS)

• TF_VARS_JSON_B64 (JSON tfvars в кодировке base64 для необходимых входных данных Terraform, кроме container_image)

Необходимые секреты среды выполнения (AWS Secrets Manager)

Настройте как карту secret_arns в Terraform (ENV_VAR_NAME => secret ARN), например:

• ENTIA_API_KEY

• Любые учетные данные API, используемые автономным MCP-сервером

• Токены 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 (base64 JSON tfvars) и запустите рабочий процесс AWS MCP Deploy.

5. Сделайте push в main или запустите рабочий процесс GitHub Actions AWS MCP Deploy.

6. Проверьте работоспособность:

   • GET https://mcp.entia.systems/health возвращает 200

   • Эндпоинт MCP доступен через ALB

   • Сервис ECS имеет работоспособные цели

Шаги внедрения (безопасные для продакшена)

1. Разверните инфраструктуру и сервис ECS без изменения DNS (create_dns_record=false) и протестируйте на DNS-имени ALB.

2. Проведите проверки работоспособности на хостнейме ALB.

3. Включите псевдоним DNS (create_dns_record=true) после подтверждения работоспособности.

4. Отслеживайте логи CloudWatch + работоспособность целей 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.

Шаги переключения DNS для mcp.entia.systems

1. Убедитесь, что сертификат ACM выдан для mcp.entia.systems в регионе развертывания.

2. Примените Terraform с create_dns_record=true, hosted_zone_id и domain_name="mcp.entia.systems".

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