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クライアント（PyPIの entia-mcp）および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パブリックイングレス、ECSはALBからのイングレスのみ許可）。

• 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を変更せずにインフラとECSサービスをデプロイし (create_dns_record=false)、ALBのDNS名でテストします。

2. ALBホスト名でスモークテストを実行します。

3. 正常であることを確認後、DNSエイリアスを有効にします (create_dns_record=true)。

4. 少なくとも1つの完全なビジネスサイクルにおいて、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