Sign inSign up

mcp/atlan-mcp-server

Verified Publisher

By mcp

•Updated about 1 year ago

MCP server for interacting with Atlan services including asset search, updates, and lineage trave...

Image
Machine learning & AI
0

3.3K

mcp/atlan-mcp-server repository overview

⁠Atlan MCP Server MCP Server

MCP server for interacting with Atlan services including asset search, updates, and lineage traversal for comprehensive data governance and discovery.

What is an MCP Server?⁠

⁠Characteristics

AttributeDetails
Docker Imagemcp/atlan-mcp-server⁠
Authoratlanhq⁠
Repositoryhttps://github.com/atlanhq/agent-toolkit⁠
Dockerfilehttps://github.com/atlanhq/agent-toolkit/blob/main/modelcontextprotocol/Dockerfile⁠
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/atlan-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
LicenceMIT License

⁠Available Tools (4)

Tools provided by this ServerShort Description
get_assets_by_dsl_toolExecute the search with the given query dsl_query : Union[str, Dict[str, Any]] (required): The DSL query used to search the index.
search_assets_toolAdvanced asset search using FluentSearch with flexible conditions.
traverse_lineage_toolTraverse asset lineage in specified direction.
update_assets_toolUpdate one or multiple assets with different values for the same attribute.

⁠Tools Details

⁠Tool: get_assets_by_dsl_tool

Execute the search with the given query dsl_query : Union[str, Dict[str, Any]] (required): The DSL query used to search the index.

Example:
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", "SnowflakeTag", "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)
ParametersTypeDescription
dsl_querystring

⁠Tool: search_assets_tool

Advanced asset search using FluentSearch with flexible conditions.

ParametersTypeDescription
asset_typestring optional
conditionsstring optional
connection_qualified_namestring optional
date_rangestring optional
directly_taggedstring optional
domain_guidsstring optional
guidsstring optional
include_archivedstring optional
include_attributesstring optional
limitstring optional
min_somesstring optional
negative_conditionsstring optional
offsetstring optional
some_conditionsstring optional
sort_bystring optional
sort_orderstring optional
tagsstring optional

⁠Tool: traverse_lineage_tool

Traverse asset lineage in specified direction.

ParametersTypeDescription
directionstring
guidstring
depthstring optional
immediate_neighborsstring optional
sizestring optional

⁠Tool: update_assets_tool

Update one or multiple assets with different values for the same attribute.

ParametersTypeDescription
assetsstring
attribute_namestring
attribute_valuesstring

⁠Use this MCP Server

{
  "mcpServers": {
    "atlan-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_AGENT_ID",
        "-e",
        "MCP_HOST",
        "-e",
        "MCP_PORT",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "ATLAN_API_KEY",
        "-e",
        "ATLAN_BASE_URL",
        "mcp/atlan-mcp-server"
      ],
      "env": {
        "ATLAN_AGENT_ID": "your-agent-id",
        "MCP_HOST": "0.0.0.0",
        "MCP_PORT": "8000",
        "MCP_TRANSPORT": "stdio",
        "ATLAN_API_KEY": "<YOUR_ATLAN_API_KEY>",
        "ATLAN_BASE_URL": "https://your-instance.atlan.com"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Tag summary

Content type

Image

Digest

sha256:b7e7e49d3…

Size

59.4 MB

Last updated

about 1 year ago

docker pull mcp/atlan-mcp-server

This week's pulls

Pulls:

11

Sep 21 to Sep 27