Atlan

आधिकारिक

Atlan का आधिकारिक MCP सर्वर जो आपको अपने AI टूल्स में मेटाडेटा की शक्ति लाने में सक्षम बनाता है

GitHub
32

Atlan MCP के साथ आप क्या कर सकते हैं?

  • एसेट्स खोजें — search_assets के साथ शर्तों का उपयोग करके डेटा एसेट्स ढूंढें।
  • DSL के माध्यम से एसेट्स प्राप्त करें — get_assets_by_dsl के साथ डोमेन-विशिष्ट भाषा क्वेरी का उपयोग करके एसेट्स प्राप्त करें।
  • डेटा लिनेज का अन्वेषण करें — traverse_lineage का उपयोग करके किसी एसेट के लिए अपस्ट्रीम और डाउनस्ट्रीम संबंधों का पता लगाएं।
  • एसेट मेटाडेटा अपडेट करें — update_assets के माध्यम से एसेट्स पर उपयोगकर्ता विवरण और प्रमाणपत्र स्थिति को संशोधित करें।
  • व्यावसायिक शब्दावलियाँ प्रबंधित करें — create_glossaries, create_glossary_categories, और create_glossary_terms का उपयोग करके शब्दावलियाँ, श्रेणियाँ और शब्द बनाएं।
  • डेटा गुणवत्ता नियमों को नियंत्रित करें — create_dq_rules, update_dq_rules, schedule_dq_rules, और delete_dq_rules के साथ डेटा गुणवत्ता नियम बनाएं, अपडेट करें, शेड्यूल करें और हटाएं।

दस्तावेज़

Atlan MCP सर्वर

[!WARNING] यह स्थानीय MCP सर्वर अप्रचलित है। इसके बजाय होस्टेड Atlan MCP का उपयोग mcp.atlan.com/mcp पर करें।

स्थानीय इंस्टॉल पथ (Docker, uv, या pip install atlan-mcp-server) केवल रखरखाव मोड में है — कोई नई सुविधाएँ नहीं, समर्थन की गारंटी नहीं। Claude Desktop, Cursor, Codex, Databricks UC और अन्य MCP क्लाइंट के साथ Atlan को एकीकृत करने के लिए होस्टेड एंडपॉइंट अनुशंसित तरीका है। सेटअप के लिए Atlan MCP अवलोकन देखें।

Atlan मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर आपके AI एजेंटों को Atlan सेवाओं के साथ इंटरैक्ट करने की अनुमति देता है।

त्वरित शुरुआत

  1. दस्तावेज़ीकरण का पालन करके Atlan API कुंजी जनरेट करें।
  2. अपनी पसंद के आधार पर निम्नलिखित में से कोई एक तरीका चुनें:

[!NOTE] कॉन्फ़िगरेशन फ़ाइल में क्रमशः <YOUR_API_KEY>, <YOUR_INSTANCE>, और <YOUR_AGENT_ID> को अपनी वास्तविक Atlan API कुंजी, इंस्टेंस URL और एजेंट ID (वैकल्पिक) से बदलना सुनिश्चित करें।

Docker के माध्यम से इंस्टॉल करें

पूर्वापेक्षाएँ:

  • अपने ऑपरेटिंग सिस्टम के लिए आधिकारिक Docker इंस्टॉलेशन गाइड का पालन करें
  • सत्यापित करें कि Docker चल रहा है: 
    docker --version

Claude Desktop में जोड़ें

Claude > Settings > Developer > Edit Config > claude_desktop_config.json पर जाएँ और जोड़ें:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

Cursor में जोड़ें

Cursor > Settings > Tools & Integrations > New MCP Server खोलें और निम्नलिखित शामिल करें:

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

uv के माध्यम से इंस्टॉल करें

पूर्वापेक्षाएँ:

  • uv इंस्टॉल करें: 
    # macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Alternative: if you already have Python/pip
pip install uv
  • इंस्टॉलेशन सत्यापित करें: 
    uv --version

[!NOTE] uv के साथ, uvx हर बार चलाने पर स्वचालित रूप से नवीनतम संस्करण प्राप्त करता है। अधिक पूर्वानुमानित व्यवहार के लिए, Docker विकल्प का उपयोग करने पर विचार करें।

Claude Desktop में जोड़ें

Claude > Settings > Developer > Edit Config > claude_desktop_config.json पर जाएँ और निम्नलिखित शामिल करें:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Cursor में जोड़ें

Cursor > Settings > Tools & Integrations > New MCP Server खोलें और निम्नलिखित शामिल करें:

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

उपलब्ध उपकरण

उपकरणविवरण
search_assetsशर्तों के आधार पर एसेट खोजें
get_assets_by_dslDSL क्वेरी का उपयोग करके एसेट पुनर्प्राप्त करें
traverse_lineageकिसी एसेट के लिए वंशावली पुनर्प्राप्त करें
update_assetsएसेट विशेषताएँ अपडेट करें (उपयोगकर्ता विवरण और प्रमाणपत्र स्थिति)
create_glossariesशब्दकोश बनाएँ
create_glossary_categoriesशब्दकोश श्रेणियाँ बनाएँ
create_glossary_termsशब्दकोश शब्द बनाएँ
create_dq_rulesटेबल, व्यू, मटेरियलाइज़्डव्यू या स्नोफ्लेकडायनामिकटेबल एसेट पर डेटा गुणवत्ता नियम बनाएँ (स्तंभ-स्तर, तालिका-स्तर, कस्टम SQL)
update_dq_rulesमौजूदा डेटा गुणवत्ता नियम अपडेट करें (सीमा, प्राथमिकता, शर्तें, आदि)
schedule_dq_rulesक्रॉन एक्सप्रेशन का उपयोग करके एसेट के लिए डेटा गुणवत्ता नियम निष्पादन शेड्यूल करें
delete_dq_rulesGUID द्वारा एक या एकाधिक डेटा गुणवत्ता नियम हटाएँ
query_assetतालिका/दृश्य एसेट पर SQL क्वेरी निष्पादित करें

उपकरण अभिगम नियंत्रण

Atlan MCP सर्वर में एक कॉन्फ़िगर करने योग्य उपकरण प्रतिबंध मिडलवेयर शामिल है जो आपको यह नियंत्रित करने की अनुमति देता है कि उपयोगकर्ताओं के लिए कौन से उपकरण उपलब्ध हैं। यह भूमिका-आधारित अभिगम नियंत्रण लागू करने या विशिष्ट वातावरणों में कुछ संचालनों को प्रतिबंधित करने के लिए उपयोगी है।

उपकरणों को प्रतिबंधित करना

आप RESTRICTED_TOOLS पर्यावरण चर का उपयोग करके विशिष्ट उपकरणों तक पहुँच प्रतिबंधित कर सकते हैं। उन उपकरण नामों की अल्पविराम-पृथक सूची प्रदान करें जिन्हें अवरुद्ध किया जाना चाहिए:

Docker कॉन्फ़िगरेशन

{
  "mcpServers": {
    "atlan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ATLAN_API_KEY=<YOUR_API_KEY>",
        "-e",
        "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com",
        "-e",
        "ATLAN_AGENT_ID=<YOUR_AGENT_ID>",
        "-e",
        "RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool",
        "ghcr.io/atlanhq/atlan-mcp-server:latest"
      ]
    }
  }
}

uv कॉन्फ़िगरेशन

{
  "mcpServers": {
    "atlan": {
      "command": "uvx",
      "args": ["atlan-mcp-server"],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>",
        "RESTRICTED_TOOLS": "get_assets_by_dsl_tool,update_assets_tool"
      }
    }
  }
}

प्रतिबंध के लिए उपलब्ध उपकरण नाम

आप निम्नलिखित में से किसी भी उपकरण को प्रतिबंधित कर सकते हैं:

  • search_assets_tool - एसेट खोज कार्यक्षमता
  • get_assets_by_dsl_tool - DSL क्वेरी निष्पादन
  • traverse_lineage_tool - वंशावली ट्रैवर्सल
  • update_assets_tool - एसेट अपडेट (विवरण, प्रमाणपत्र)
  • create_glossaries - शब्दकोश निर्माण
  • create_glossary_categories - श्रेणी निर्माण
  • create_glossary_terms - शब्द निर्माण
  • create_dq_rules_tool - डेटा गुणवत्ता नियम निर्माण
  • update_dq_rules_tool - डेटा गुणवत्ता नियम अपडेट
  • schedule_dq_rules_tool - डेटा गुणवत्ता नियम शेड्यूलिंग
  • delete_dq_rules_tool - डेटा गुणवत्ता नियम विलोपन

सामान्य उपयोग के मामले

केवल-पढ़ने की पहुँच

सभी लेखन संचालन प्रतिबंधित करें:

RESTRICTED_TOOLS=update_assets_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

DSL क्वेरी अक्षम करें

सुरक्षा या प्रदर्शन कारणों से:

RESTRICTED_TOOLS=get_assets_by_dsl_tool

न्यूनतम पहुँच

केवल बुनियादी खोज की अनुमति दें:

RESTRICTED_TOOLS=get_assets_by_dsl_tool,update_assets_tool,traverse_lineage_tool,create_glossaries,create_glossary_categories,create_glossary_terms,create_dq_rules_tool,update_dq_rules_tool,schedule_dq_rules_tool,delete_dq_rules_tool

यह कैसे काम करता है

जब उपकरण प्रतिबंधित होते हैं:

  1. लिस्टिंग से छिपा हुआ: जब क्लाइंट उपलब्ध उपकरणों का अनुरोध करते हैं तो प्रतिबंधित उपकरण दिखाई नहीं देंगे
  2. निष्पादन अवरुद्ध: यदि कोई प्रतिबंधित उपकरण निष्पादित करने का प्रयास करता है, तो उन्हें एक स्पष्ट त्रुटि संदेश प्राप्त होगा
  3. लॉग किया गया: निगरानी और डिबगिंग के लिए सभी पहुँच निर्णय लॉग किए जाते हैं

कोई प्रतिबंध नहीं (डिफ़ॉल्ट)

यदि आप RESTRICTED_TOOLS पर्यावरण चर सेट नहीं करते हैं, तो डिफ़ॉल्ट रूप से सभी उपकरण उपलब्ध होंगे।

ट्रांसपोर्ट मोड

Atlan MCP सर्वर तीन ट्रांसपोर्ट मोड का समर्थन करता है, प्रत्येक विभिन्न परिनियोजन परिदृश्यों के लिए अनुकूलित है। MCP ट्रांसपोर्ट मोड के बारे में अधिक जानकारी के लिए, आधिकारिक MCP दस्तावेज़ीकरण देखें।

ट्रांसपोर्ट मोडउपयोग का मामलालाभकब उपयोग करें
stdio (डिफ़ॉल्ट)स्थानीय विकास, IDE एकीकरणसरल, सीधा संचारClaude Desktop, Cursor IDE
SSE (सर्वर-प्रेषित ईवेंट)दूरस्थ परिनियोजन, वेब ब्राउज़ररीयल-टाइम स्ट्रीमिंग, वेब-संगतक्लाउड परिनियोजन, वेब क्लाइंट
streamable-httpHTTP-आधारित दूरस्थ कनेक्शनमानक HTTP, लोड बैलेंसर अनुकूलKubernetes, कंटेनरीकृत परिनियोजन

व्यापक परिनियोजन निर्देशों, कॉन्फ़िगरेशन उदाहरणों और उत्पादन सर्वोत्तम प्रथाओं के लिए, हमारी परिनियोजन गाइड देखें।

उत्पादन परिनियोजन

  • अपनी पसंद के क्लाउड/प्लेटफ़ॉर्म पर Atlan MCP कंटेनर छवि होस्ट करें
  • सुनिश्चित करें कि आप सभी आवश्यक पर्यावरण चर जोड़ते हैं
  • अपने परिनियोजन परिदृश्य के लिए उपयुक्त ट्रांसपोर्ट मोड चुनें। उत्पादन के लिए SSE ट्रांसपोर्ट अनुशंसित है (-e MCP_TRANSPORT=sse)
  • विस्तृत परिनियोजन परिदृश्यों और कॉन्फ़िगरेशन के लिए, परिनियोजन गाइड देखें

दूरस्थ MCP कॉन्फ़िगरेशन

वर्तमान में हमारे पास Atlan के लिए आम तौर पर उपलब्ध कोई दूरस्थ MCP सर्वर नहीं है।

आप इसे अपने दूरस्थ MCP सर्वर से कनेक्ट करने के लिए mcp-remote स्थानीय प्रॉक्सी उपकरण का उपयोग कर सकते हैं।

यह आपको एक वास्तविक दुनिया के MCP क्लाइंट के साथ आपके दूरस्थ MCP सर्वर के साथ इंटरैक्शन कैसा होगा, इसका परीक्षण करने देता है।

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": ["mcp-remote", "https://hosted-domain"]
    }
  }
}

स्थानीय रूप से विकसित करें

स्थानीय रूप से विकसित करना चाहते हैं? चरण-दर-चरण वॉकथ्रू के लिए हमारी स्थानीय बिल्ड गाइड देखें!

सहायता चाहिए?

  • किसी भी प्रश्न या प्रतिक्रिया के लिए support@atlan.com पर संपर्क करें
  • आप सीधे GitHub मुद्दा भी बना सकते हैं और हम आपके लिए इसका उत्तर देंगे

अक्सर पूछे जाने वाले प्रश्न

क्या मुझे Python इंस्टॉल करने की आवश्यकता है?

संक्षिप्त उत्तर: यह आपकी इंस्टॉलेशन विधि पर निर्भर करता है।

  • Docker (अनुशंसित): आपकी होस्ट मशीन पर किसी Python इंस्टॉलेशन की आवश्यकता नहीं है। कंटेनर में आवश्यक सब कुछ शामिल है।
  • uv: Python रनटाइम की आवश्यकता है, लेकिन uv स्वचालित रूप से Python 3.11+ डाउनलोड और प्रबंधित करेगा यदि यह पहले से उपलब्ध नहीं है।

तकनीकी विवरण: Atlan MCP सर्वर एक Python अनुप्रयोग के रूप में कार्यान्वित किया गया है। मॉडल कॉन्टेक्स्ट प्रोटोकॉल स्वयं भाषा-अज्ञेय है, लेकिन हमारे वर्तमान कार्यान्वयन को चलाने के लिए Python 3.11+ की आवश्यकता है।

समस्या निवारण

  1. यदि Claude Desktop spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\n at ChildProcess._handle.onexit जैसी कोई त्रुटि दिखाता है, तो यह सबसे अधिक संभावना यह मुद्दा है जहाँ Claude uv खोजने में असमर्थ है। इसे ठीक करने के लिए:
    • सुनिश्चित करें कि uv इंस्टॉल है और आपके PATH में उपलब्ध है
    • इंस्टॉलेशन पथ सत्यापित करने के लिए which uv चलाएँ
    • whereis uv चलाकर सटीक uv पथ पर इंगित करने के लिए Claude के कॉन्फ़िगरेशन को अपडेट करें और उस पथ का उपयोग करें