mcp/atlan

Atlan MCP Server

概述

用于与Atlan服务交互的MCP服务器，包括资产搜索、更新和谱系遍历，支持全面的数据治理和发现。

什么是MCP服务器？

特性

可用工具（7个）

工具详情

工具：create_glossaries

在Atlan中创建一个或多个AtlasGlossary资产。

重要业务规则与约束：

• 检查同一请求中的重复名称，并要求用户选择不同名称
• 创建词汇表前不要使用搜索工具 - Atlan会处理存在性验证
• 如果用户指令不明确，需询问澄清问题

工具：create_glossary_categories

在Atlan中创建一个或多个AtlasGlossaryCategory资产。

重要业务规则与约束：

• 同一词汇表下同一层级不能有两个同名类别
• 父类别下同一层级不能有同名子类别
• 不同词汇表下可以有同名类别（允许）
• 跨层级命名允许：类别"a"可以有子类别"b"，类别"b"可以有子类别"a"
• 允许的结构示例：词汇表"bui"→类别"a"→子类别"b" 以及 类别"b"→子类别"a"
• 必须检查同一层级的重复名称，并要求用户选择不同名称
• 创建类别前，执行一次搜索以检查是否已存在同名的词汇表或类别。如果已有所需GUID，则跳过此步骤。
• 创建类别前搜索词汇表和类别的示例调用（查询 - 在"Marvel Cinematic Universe (MCU)"词汇表下创建"Locations"和"Characters"类别）： { "limit": 10, "conditions": { "type_name": ["AtlasGlossary", "AtlasGlossaryCategory"], "name": ["Marvel Cinematic Universe (MCU)", "Characters", "Locations"] } }
• 如果用户指令不明确，需询问澄清问题

工具：create_glossary_terms

在Atlan中创建一个或多个AtlasGlossaryTerm资产。

重要业务规则与约束：

• 在一个词汇表中，一个术语（单个GUID）可以关联多个类别
• 同一词汇表中不能存在两个同名术语（无论类别如何）
• 术语始终锚定到一个词汇表，也可关联同一词汇表内的一个或多个类别
• 创建术语前，执行一次搜索以检查是否已存在同名的词汇表、类别或术语。在一次调用中搜索所有相关词汇表、类别和术语。如果已有所需GUID，则跳过此步骤。
• 创建术语前搜索词汇表、类别和术语的示例调用（查询 - 在"Marvel Cinematic Universe (MCU)"词汇表下的"Characters"和"Locations"类别中创建术语"fighterz"）： { "limit": 10, "conditions": { "type_name": ["AtlasGlossary", "AtlasGlossaryCategory","AtlasGlossaryTerm"], "name": ["Marvel Cinematic Universe (MCU)", "Characters", "Locations","fighterz"] } }

工具：get_assets_by_dsl_tool

使用给定的查询执行搜索 dsl_query: Union[str, Dict[str, Any]]（必填）： 用于搜索索引的DSL查询。

示例： dsl_query = '''{ "query": { "function_score": { "boost_mode": "sum", "functions": [ {"filter": {"match": {"starredBy": "john.doe"}}, "weight": 10}, {"filter": {"match": {"certificateStatus": "VERIFIED"}}, "weight": 15}, {"filter": {"match": {"certificateStatus": "DRAFT"}}, "weight": 10}, {"filter": {"bool": {"must_not": [{"exists": {"field": "certificateStatus"}}]}}, "weight": 8}, {"filter": {"bool": {"must_not": [{"terms": {"__typeName.keyword": ["Process", "DbtProcess"]}}]}}, "weight": 20} ], "query": { "bool": { "filter": [ { "bool": { "minimum_should_match": 1, "must": [ {"bool": {"should": [{"terms": {"certificateStatus": ["VERIFIED"]}}]}}, {"term": {"__state": "ACTIVE"}} ], "must_not": [ {"term": {"isPartial": "true"}}, {"terms": {"__typeName.keyword": ["Procedure", "DbtColumnProcess", "BIProcess", "MatillionComponent", "***Tag", "DbtTag", "BigqueryTag", "AIApplication", "AIModel"]}}, {"terms": {"__typeName.keyword": ["MCIncident", "AnomaloCheck"]}} ], "should": [ {"terms": {"__typeName.keyword": ["Query", "Collection", "AtlasGlossary", "AtlasGlossaryCategory", "AtlasGlossaryTerm", "Connection", "File"]}}, ] } } ] }, "score_mode": "sum" }, "score_mode": "sum" } }, "post_filter": { "bool": { "filter": [ { "bool": { "must": [{"terms": {"__typeName.keyword": ["Table", "Column"]}}], "must_not": [{"exists": {"field": "termType"}}] } } ] }, "sort": [ {"_score": {"order": "desc"}}, {"popularityScore": {"order": "desc"}}, {"starredCount": {"order": "desc"}}, {"name.keyword": {"order": "asc"}} ], "track_total_hits": true, "size": 10, "include_meta": false }''' response = get_assets_by_dsl(dsl_query)

工具：search_assets_tool

使用FluentSearch进行高级资产搜索，支持灵活条件。

工具：traverse_lineage_tool

按指定方向遍历资产谱系。

默认情况下，结果中包含基本属性。可通过include_attributes参数指定其他属性，以获取更丰富的谱系信息。

工具：update_assets_tool

使用同一属性的不同值更新一个或多个资产。

使用此MCP服务器

json
{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY",
        "-e",
        "ATLAN_BASE_URL",
        "mcp/atlan"
      ],
      "env": {
        "ATLAN_API_KEY": "<YOUR_ATLAN_API_KEY>",
        "ATLAN_BASE_URL": "https://your-instance.atlan.com"
      }
    }
  }
}

为什么使用Docker运行MCP服务器更安全？