StarRocks MCP Server

आधिकारिक

StarRocks के साथ इंटरैक्ट करें

दस्तावेज़

StarRocks आधिकारिक MCP सर्वर

StarRocks MCP सर्वर AI सहायकों और StarRocks डेटाबेस के बीच एक सेतु का काम करता है। यह जटिल क्लाइंट-साइड सेटअप की आवश्यकता के बिना सीधे SQL निष्पादन, डेटाबेस अन्वेषण, चार्ट के माध्यम से डेटा विज़ुअलाइज़ेशन और विस्तृत स्कीमा/डेटा अवलोकन प्राप्त करने की अनुमति देता है।

विशेषताएँ

सीधा SQL निष्पादन: SELECT क्वेरीज़ (read_query) और DDL/DML कमांड (write_query) चलाएँ।
डेटाबेस अन्वेषण: डेटाबेस और तालिकाओं को सूचीबद्ध करें, तालिका स्कीमा (starrocks:// संसाधन) प्राप्त करें।
सिस्टम जानकारी: proc:// संसाधन पथ के माध्यम से आंतरिक StarRocks मेट्रिक्स और स्थितियों तक पहुँचें।
विस्तृत अवलोकन: स्तंभ परिभाषाएँ, पंक्ति गणना और नमूना डेटा सहित तालिकाओं (table_overview) या संपूर्ण डेटाबेस (db_overview) का व्यापक सारांश प्राप्त करें।
डेटा विज़ुअलाइज़ेशन: एक क्वेरी निष्पादित करें और परिणामों से सीधे एक Plotly चार्ट उत्पन्न करें (query_and_plotly_chart)।
बुद्धिमान कैशिंग: बार-बार अनुरोधों को गति देने के लिए तालिका और डेटाबेस अवलोकन मेमोरी में कैश किए जाते हैं। आवश्यकता पड़ने पर कैश को दरकिनार किया जा सकता है।
लचीला कॉन्फ़िगरेशन: पर्यावरण चर के माध्यम से कनेक्शन विवरण और व्यवहार सेट करें।

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

Python 3.11 या नया।
एक सुलभ StarRocks क्लस्टर (FE सेवा)। डिफ़ॉल्ट रूप से सर्वर MySQL प्रोटोकॉल पर localhost:9030 से जुड़ता है।
uv — Astral का एक तेज़ Python पैकेज और प्रोजेक्ट मैनेजर (pip + virtualenv का आधुनिक प्रतिस्थापन)। यह प्रोजेक्ट निर्भरताओं को हल करने, वर्चुअल वातावरण बनाने और सर्वर लॉन्च करने के लिए uv का उपयोग करता है। इस README में दिए गए uv run कमांड पहले उपयोग पर स्वचालित रूप से एक पृथक वातावरण बनाते हैं और आवश्यक निर्भरताएँ स्थापित करते हैं, इसलिए किसी मैन्युअल pip install चरण की आवश्यकता नहीं है।

`uv` स्थापित करना

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

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

# Or via Homebrew / pipx / pip
brew install uv
# pipx install uv
# pip install uv

अन्य विकल्पों के लिए आधिकारिक uv स्थापना गाइड देखें। स्थापित करने के बाद, सत्यापित करें कि यह आपके PATH पर है:

uv --version

स्थापना

आपको आम तौर पर पैकेज को मैन्युअल रूप से स्थापित करने की आवश्यकता नहीं होती है — MCP होस्ट इसे uv के माध्यम से आपके लिए लॉन्च करता है (नीचे कॉन्फ़िगरेशन देखें)। uv मांग पर पैकेज और इसकी निर्भरताएँ प्राप्त करता है।

परीक्षण या विकास के लिए इसे सीधे चलाने हेतु:

# Run the published package in a throwaway environment
uv run --with mcp-server-starrocks mcp-server-starrocks --help

# Or, from a local checkout of this repository
git clone https://github.com/starrocks/mcp-server-starrocks.git
cd mcp-server-starrocks
uv sync                      # create the virtual environment and install dependencies
uv run mcp-server-starrocks --help

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

MCP सर्वर आमतौर पर MCP होस्ट के माध्यम से चलाया जाता है। कॉन्फ़िगरेशन होस्ट को पास किया जाता है, जो यह निर्दिष्ट करता है कि StarRocks MCP सर्वर प्रक्रिया कैसे लॉन्च की जाए।

स्ट्रीमेबल HTTP का उपयोग करना (अनुशंसित):

सर्वर को स्ट्रीमेबल HTTP मोड में प्रारंभ करने के लिए:

पहले परीक्षण करें कि StarRocks से कनेक्शन ठीक है (9030 StarRocks MySQL प्रोटोकॉल पोर्ट है, HTTP सर्वर पोर्ट नहीं):

$ STARROCKS_URL=root:@localhost:9030 uv run mcp-server-starrocks --test

सर्वर प्रारंभ करें:

uv run mcp-server-starrocks --mode streamable-http --port 8000

फिर MCP को इस प्रकार कॉन्फ़िगर करें:

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

स्थापित पैकेज के साथ uv का उपयोग करना (व्यक्तिगत पर्यावरण चर):

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": ["run", "--with", "mcp-server-starrocks", "mcp-server-starrocks"],
      "env": {
        "STARROCKS_HOST": "default localhost",
        "STARROCKS_PORT": "default 9030",
        "STARROCKS_USER": "default root",
        "STARROCKS_PASSWORD": "default empty",
        "STARROCKS_DB": "default empty"
      }
    }
  }
}

स्थापित पैकेज के साथ uv का उपयोग करना (कनेक्शन URL):

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": ["run", "--with", "mcp-server-starrocks", "mcp-server-starrocks"],
      "env": {
        "STARROCKS_URL": "root:password@localhost:9030/my_database"
      }
    }
  }
}

स्थानीय निर्देशिका के साथ uv का उपयोग करना (विकास के लिए):

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mcp-server-starrocks", // <-- Update this path
        "run",
        "mcp-server-starrocks"
      ],
      "env": {
        "STARROCKS_HOST": "default localhost",
        "STARROCKS_PORT": "default 9030",
        "STARROCKS_USER": "default root",
        "STARROCKS_PASSWORD": "default empty",
        "STARROCKS_DB": "default empty"
      }
    }
  }
}

स्थानीय निर्देशिका और कनेक्शन URL के साथ uv का उपयोग करना:

{
  "mcpServers": {
    "mcp-server-starrocks": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mcp-server-starrocks", // <-- Update this path
        "run",
        "mcp-server-starrocks"
      ],
      "env": {
        "STARROCKS_URL": "root:password@localhost:9030/my_database"
      }
    }
  }
}

कमांड-लाइन तर्क:

सर्वर निम्नलिखित कमांड-लाइन तर्कों का समर्थन करता है:

uv run mcp-server-starrocks --help

--mode {stdio,sse,http,streamable-http}: ट्रांसपोर्ट मोड (डिफ़ॉल्ट: stdio या MCP_TRANSPORT_MODE env var)
--host HOST: HTTP मोड के लिए सर्वर होस्ट (डिफ़ॉल्ट: localhost)
--port PORT: HTTP मोड के लिए सर्वर पोर्ट
--test: कार्यक्षमता सत्यापित करने के लिए परीक्षण मोड में चलाएँ

उदाहरण:

# Start in streamable HTTP mode on custom host/port
uv run mcp-server-starrocks --mode streamable-http --host 0.0.0.0 --port 8080

# Start in stdio mode (default)
uv run mcp-server-starrocks --mode stdio

# Run test mode
uv run mcp-server-starrocks --test

url फ़ील्ड को आपके MCP सर्वर के स्ट्रीमेबल HTTP एंडपॉइंट की ओर इंगित करना चाहिए (आवश्यकतानुसार होस्ट/पोर्ट समायोजित करें)।
इस कॉन्फ़िगरेशन के साथ, क्लाइंट HTTP POST अनुरोधों पर मानक JSON का उपयोग करके सर्वर के साथ इंटरैक्ट कर सकते हैं। किसी विशेष SDK की आवश्यकता नहीं है।
सभी टूल API ऊपर वर्णित अनुसार मानक JSON स्वीकार करते हैं और लौटाते हैं।

नोट: sse (सर्वर-सेंट इवेंट्स) मोड पदावनत है और अब अनुरक्षित नहीं है। कृपया सभी नए एकीकरणों के लिए स्ट्रीमेबल HTTP मोड का उपयोग करें।

पर्यावरण चर:

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

आप व्यक्तिगत पर्यावरण चर या एकल कनेक्शन URL का उपयोग करके StarRocks कनेक्शन कॉन्फ़िगर कर सकते हैं:

विकल्प 1: व्यक्तिगत पर्यावरण चर

STARROCKS_HOST: (वैकल्पिक) StarRocks FE सेवा का होस्टनाम या IP पता। डिफ़ॉल्ट localhost है।
STARROCKS_PORT: (वैकल्पिक) StarRocks FE सेवा का MySQL प्रोटोकॉल पोर्ट। डिफ़ॉल्ट 9030 है।
STARROCKS_USER: (वैकल्पिक) StarRocks उपयोगकर्ता नाम। डिफ़ॉल्ट root है।
STARROCKS_PASSWORD: (वैकल्पिक) StarRocks पासवर्ड। डिफ़ॉल्ट खाली स्ट्रिंग है।
STARROCKS_PASSWORD_KEYCHAIN_SERVICE: (वैकल्पिक, केवल macOS) कीचेन से पासवर्ड पढ़ते समय उपयोग करने के लिए सामान्य पासवर्ड सेवा नाम। इसका उपयोग केवल तब किया जाता है जब STARROCKS_PASSWORD या STARROCKS_URL के माध्यम से कोई स्पष्ट पासवर्ड प्रदान नहीं किया जाता है।
STARROCKS_PASSWORD_KEYCHAIN_ACCOUNT: (वैकल्पिक, केवल macOS) कीचेन से पासवर्ड पढ़ते समय उपयोग करने के लिए सामान्य पासवर्ड खाता नाम। डिफ़ॉल्ट हल किए गए StarRocks उपयोगकर्ता पर सेट होता है।
STARROCKS_DB: (वैकल्पिक) यदि टूल तर्कों या संसाधन URI में निर्दिष्ट नहीं है तो उपयोग करने के लिए डिफ़ॉल्ट डेटाबेस। यदि सेट किया गया है, तो कनेक्शन इस डेटाबेस को USE करने का प्रयास करेगा। table_overview और db_overview जैसे उपकरण इसका उपयोग करेंगे यदि उनके तर्कों में डेटाबेस भाग छोड़ा गया है। डिफ़ॉल्ट खाली है (कोई डिफ़ॉल्ट डेटाबेस नहीं)।

विकल्प 2: कनेक्शन URL (व्यक्तिगत चर पर प्राथमिकता लेता है)

STARROCKS_URL: (वैकल्पिक) एक कनेक्शन URL स्ट्रिंग जिसमें एकल चर में सभी कनेक्शन पैरामीटर शामिल हैं। प्रारूप: [<schema>://]user:password@host:port/database। स्कीमा भाग वैकल्पिक है। जब यह चर सेट किया जाता है, तो यह व्यक्तिगत STARROCKS_HOST, STARROCKS_PORT, STARROCKS_USER, STARROCKS_PASSWORD, और STARROCKS_DB चरों पर प्राथमिकता लेता है।

उदाहरण:
- root:mypass@localhost:9030/test_db
- mysql://admin:[email protected]:9030/production
- starrocks://user:[email protected]:9030/analytics

पासवर्ड प्राथमिकता:

STARROCKS_URL में एम्बेडेड पासवर्ड जीतता है, जिसमें user:@host:9030/db जैसा स्पष्ट खाली पासवर्ड भी शामिल है।
यदि STARROCKS_URL पासवर्ड छोड़ता है, तो सेट होने पर STARROCKS_PASSWORD का उपयोग किया जाता है।
यदि कोई स्पष्ट पासवर्ड स्रोत सेट नहीं है और STARROCKS_PASSWORD_KEYCHAIN_SERVICE कॉन्फ़िगर किया गया है, तो पासवर्ड macOS कीचेन से पढ़ा जाता है।

macOS कीचेन उदाहरण

पासवर्ड संग्रहीत करें:

security add-generic-password -U -a root -s mcp-server-starrocks -w 'secret'

संग्रहीत पासवर्ड सत्यापित करें:

security find-generic-password -a root -s mcp-server-starrocks -w

इस सर्वर के साथ इसका उपयोग करें:

export STARROCKS_URL=root@localhost:9030/test_db
export STARROCKS_PASSWORD_KEYCHAIN_SERVICE=mcp-server-starrocks
export STARROCKS_PASSWORD_KEYCHAIN_ACCOUNT=root

अतिरिक्त कॉन्फ़िगरेशन

STARROCKS_FE_ARROW_FLIGHT_SQL_PORT: (वैकल्पिक) StarRocks FE सेवा का Arrow Flight SQL पोर्ट। सेट होने पर, सर्वर मानक MySQL प्रोटोकॉल के बजाय उच्च-प्रदर्शन Arrow Flight SQL प्रोटोकॉल (ADBC ड्राइवरों के माध्यम से) का उपयोग करके जुड़ता है। डिफ़ॉल्ट MySQL कनेक्शन का उपयोग करने के लिए अनसेट छोड़ दें। होस्ट, उपयोगकर्ता और पासवर्ड ऊपर वर्णित समान कनेक्शन सेटिंग्स से लिए गए हैं।
STARROCKS_OVERVIEW_LIMIT: (वैकल्पिक) कैश को पॉप्युलेट करने के लिए डेटा प्राप्त करते समय अवलोकन उपकरणों (table_overview, db_overview) द्वारा उत्पन्न कुल पाठ के लिए एक अनुमानित वर्ण सीमा। यह बहुत बड़ी स्कीमा या अनेक तालिकाओं के लिए अत्यधिक मेमोरी उपयोग को रोकने में मदद करता है। डिफ़ॉल्ट 20000 है।
STARROCKS_MCP_OUTPUT_DIR: (वैकल्पिक) read_query द्वारा उपयोग की जाने वाली निर्देशिका जब इसका output_file तर्क एक सापेक्ष पथ होता है। डिफ़ॉल्ट ~/.mcp-server-starrocks/output/ है। निर्देशिका मांग पर बनाई जाती है। output_file को दिए गए निरपेक्ष पथ (~-उपसर्ग वाले पथों सहित) इस सेटिंग को दरकिनार करते हैं। नोट: फ़ाइलें उस मशीन पर लिखी जाती हैं जहाँ MCP सर्वर चलता है। Claude Code / Claude Desktop के लिए सर्वर स्थानीय रूप से चलता है, इसलिए फ़ाइलें आपके लैपटॉप पर आती हैं। दूरस्थ/http परिनियोजन के लिए फ़ाइल सर्वर पर आती है, क्लाइंट पर नहीं।
STARROCKS_MYSQL_AUTH_PLUGIN: (वैकल्पिक) StarRocks FE सेवा से कनेक्ट करते समय उपयोग करने के लिए प्रमाणीकरण प्लगइन निर्दिष्ट करता है। उदाहरण के लिए, यदि आपके StarRocks परिनियोजन को स्पष्ट पाठ पासवर्ड प्रमाणीकरण की आवश्यकता है (जैसे कि कुछ LDAP या बाहरी प्रमाणीकरण सेटअप का उपयोग करते समय) तो mysql_clear_password पर सेट करें। इसे केवल तभी सेट करें जब आपके वातावरण को विशेष रूप से इसकी आवश्यकता हो; अन्यथा, डिफ़ॉल्ट auth_plugin का उपयोग किया जाता है।
MCP_TRANSPORT_MODE: (वैकल्पिक) संचार मोड जो निर्दिष्ट करता है कि MCP सर्वर अपनी सेवाएँ कैसे प्रस्तुत करता है। उपलब्ध विकल्प:
- stdio (डिफ़ॉल्ट): मानक इनपुट/आउटपुट के माध्यम से संचार करता है, MCP होस्ट होस्टिंग के लिए उपयुक्त।
- streamable-http (स्ट्रीमेबल HTTP): एक स्ट्रीमेबल HTTP सर्वर के रूप में प्रारंभ होता है, RESTful API कॉल का समर्थन करता है।
- sse: (पदावनत, अनुशंसित नहीं) सर्वर-सेंट इवेंट्स (SSE) स्ट्रीमिंग मोड में प्रारंभ होता है, स्ट्रीमिंग प्रतिक्रियाओं की आवश्यकता वाले परिदृश्यों के लिए उपयुक्त। नोट: SSE मोड अब अनुरक्षित नहीं है, समान रूप से स्ट्रीमेबल HTTP मोड का उपयोग करने की अनुशंसा की जाती है।

घटक

उपकरण

read_query
- विवरण: एक SELECT क्वेरी या अन्य कमांड निष्पादित करें जो एक ResultSet लौटाते हैं (जैसे, SHOW, DESCRIBE)। वैकल्पिक रूप से पूर्ण परिणाम को इनलाइन लौटाने के बजाय एक स्थानीय फ़ाइल में लिखें — मॉडल संदर्भ में फ़िट होने के लिए बहुत बड़े परिणामों के लिए उपयोगी।
- इनपुट:
```
{
  "query": "SQL query string",
  "db": "database name (optional, uses default database if not specified)",
  "output_file": "optional path; if set, writes the full result to disk and returns only a summary + small preview. Relative paths resolve against STARROCKS_MCP_OUTPUT_DIR (default: ~/.mcp-server-starrocks/output/); absolute paths and ~ are used as-is",
  "output_format": "optional: csv | tsv | json | jsonl. If omitted, inferred from output_file extension (.csv/.tsv/.json/.jsonl/.ndjson); defaults to csv"
}
```
- आउटपुट: output_file के बिना, हेडर पंक्ति और पंक्ति गणना सारांश के साथ CSV-जैसे प्रारूप में क्वेरी परिणामों वाली पाठ सामग्री। output_file के साथ, हल किए गए निरपेक्ष पथ, बाइट गणना और पंक्ति गणना सहित एक संक्षिप्त सारांश, साथ ही एक छोटा पूर्वावलोकन। विफलता पर एक त्रुटि संदेश लौटाता है।
write_query
- विवरण: एक DDL (CREATE, ALTER, DROP), DML (INSERT, UPDATE, DELETE), या अन्य StarRocks कमांड निष्पादित करें जो ResultSet नहीं लौटाता है।
- इनपुट:
```
{
  "query": "SQL command string",
  "db": "database name (optional, uses default database if not specified)"
}
```
- आउटपुट: सफलता की पुष्टि करने वाली पाठ सामग्री (जैसे, "Query OK, X rows affected") या त्रुटि की रिपोर्ट करना। सफलता पर परिवर्तन स्वचालित रूप से कमिट किए जाते हैं।
analyze_query
- विवरण: क्वेरी प्रोफ़ाइल या explain analyze का उपयोग करके किसी क्वेरी का विश्लेषण करें और विश्लेषण परिणाम प्राप्त करें।
- इनपुट:
```
{
  "uuid": "Query ID, a string composed of 32 hexadecimal digits formatted as 8-4-4-4-12",
  "sql": "Query SQL to analyze",
  "db": "database name (optional, uses default database if not specified)"
}
```
- आउटपुट: क्वेरी विश्लेषण परिणामों वाली पाठ सामग्री। यदि uuid प्रदान किया गया है तो ANALYZE PROFILE FROM का उपयोग करता है, अन्यथा यदि sql प्रदान किया गया है तो EXPLAIN ANALYZE का उपयोग करता है।
query_and_plotly_chart
- विवरण: एक SQL क्वेरी निष्पादित करता है, परिणामों को Pandas DataFrame में लोड करता है, और प्रदान की गई Python अभिव्यक्ति का उपयोग करके एक Plotly चार्ट उत्पन्न करता है। समर्थन करने वाले UI में विज़ुअलाइज़ेशन के लिए डिज़ाइन किया गया।
- इनपुट:
```
{
  "query": "SQL query to fetch data",
  "plotly_expr": "Python expression string using 'px' (Plotly Express) and 'df' (DataFrame). Example: 'px.scatter(df, x=\"col1\", y=\"col2\")'",
  "db": "database name (optional, uses default database if not specified)"
}
```
- आउटपुट: एक सूची जिसमें शामिल हैं:
  1. TextContent: DataFrame का एक पाठ प्रतिनिधित्व और एक नोट कि चार्ट UI प्रदर्शन के लिए है।
  2. ImageContent: बेस64 PNG छवि (image/png) के रूप में एन्कोडेड उत्पन्न Plotly चार्ट। विफलता पर या यदि क्वेरी कोई डेटा नहीं देती है तो पाठ त्रुटि संदेश लौटाता है।
table_overview
- विवरण: किसी विशिष्ट तालिका का अवलोकन प्राप्त करें: स्तंभ (DESCRIBE से), कुल पंक्ति गणना, और नमूना पंक्तियाँ (LIMIT 3)। जब तक refresh सत्य न हो, इन-मेमोरी कैश का उपयोग करता है।
- इनपुट:
```
{
  "table": "Table name, optionally prefixed with database name (e.g., 'db_name.table_name' or 'table_name'). If database is omitted, uses STARROCKS_DB environment variable if set.",
  "refresh": false // Optional, boolean. Set to true to bypass the cache. Defaults to false.
}
```
- आउटपुट: स्वरूपित अवलोकन (स्तंभ, पंक्ति गणना, नमूना डेटा) या एक त्रुटि संदेश वाली पाठ सामग्री। कैश्ड परिणामों में लागू होने पर पिछली त्रुटियाँ शामिल होती हैं।
db_overview
- विवरण: किसी निर्दिष्ट डेटाबेस के भीतर सभी तालिकाओं के लिए एक अवलोकन (स्तंभ, पंक्ति गणना, नमूना पंक्तियाँ) प्राप्त करें। जब तक refresh सत्य न हो, प्रत्येक तालिका के लिए तालिका-स्तरीय कैश का उपयोग करता है।
- इनपुट:
```
{
  "db": "database_name", // Optional if default database is set.
  "refresh": false // Optional, boolean. Set to true to bypass the cache for all tables in the DB. Defaults to false.
}
```
- आउटपुट: डेटाबेस में पाई गई सभी तालिकाओं के लिए संयोजित अवलोकनों वाली पाठ सामग्री, हेडर द्वारा अलग की गई। यदि डेटाबेस तक नहीं पहुँचा जा सकता है या इसमें कोई तालिका नहीं है तो एक त्रुटि संदेश लौटाता है।

संसाधन

प्रत्यक्ष संसाधन

starrocks:///databases
- विवरण: कॉन्फ़िगर किए गए उपयोगकर्ता के लिए सुलभ सभी डेटाबेस सूचीबद्ध करता है।
- समतुल्य क्वेरी: SHOW DATABASES
- MIME प्रकार: text/plain

संसाधन टेम्पलेट

starrocks:///{db}/{table}/schema
- विवरण: किसी विशिष्ट तालिका की स्कीमा परिभाषा प्राप्त करता है।
- समतुल्य क्वेरी: SHOW CREATE TABLE {db}.{table}
- MIME प्रकार: text/plain
starrocks:///{db}/tables
- विवरण: किसी विशिष्ट डेटाबेस के भीतर सभी तालिकाओं को सूचीबद्ध करता है।
- समतुल्य क्वेरी: SHOW TABLES FROM {db}
- MIME प्रकार: text/plain
proc:///{+path}
- विवरण: StarRocks आंतरिक सिस्टम जानकारी तक पहुँचता है, Linux /proc के समान। path पैरामीटर वांछित सूचना नोड निर्दिष्ट करता है।
- समतुल्य क्वेरी: SHOW PROC '/{path}'
- MIME प्रकार: text/plain
- सामान्य पथ:
  - /frontends - FE नोड्स के बारे में जानकारी।
  - /backends - BE नोड्स के बारे में जानकारी (गैर-क्लाउड नेटिव परिनियोजन के लिए)।
  - /compute_nodes - CN नोड्स के बारे में जानकारी (क्लाउड नेटिव परिनियोजन के लिए)।
  - /dbs - डेटाबेस के बारे में जानकारी।
  - /dbs/<DB_ID> - ID द्वारा किसी विशिष्ट डेटाबेस के बारे में जानकारी।
  - /dbs/<DB_ID>/<TABLE_ID> - ID द्वारा किसी विशिष्ट तालिका के बारे में जानकारी।
  - /dbs/<DB_ID>/<TABLE_ID>/partitions - किसी तालिका के लिए विभाजन जानकारी।
  - /transactions - डेटाबेस द्वारा समूहीकृत लेन-देन जानकारी।
  - /transactions/<DB_ID> - किसी विशिष्ट डेटाबेस ID के लिए लेन-देन जानकारी।
  - /transactions/<DB_ID>/running - किसी डेटाबेस ID के लिए चल रहे लेन-देन।
  - /transactions/<DB_ID>/finished - किसी डेटाबेस ID के लिए समाप्त लेन-देन।
  - /jobs - अतुल्यकालिक कार्यों (स्कीमा परिवर्तन, रोलअप, आदि) के बारे में जानकारी।
  - /statistic - प्रत्येक डेटाबेस के लिए सांख्यिकी।
  - /tasks - एजेंट कार्यों के बारे में जानकारी।
  - /cluster_balance - लोड संतुलन स्थिति जानकारी।
  - /routine_loads - रूटीन लोड कार्यों के बारे में जानकारी।
  - /colocation_group - कोलोकेशन जॉइन समूहों के बारे में जानकारी।
  - /catalog - कॉन्फ़िगर किए गए कैटलॉग (जैसे, Hive, Iceberg) के बारे में जानकारी।

प्रॉम्प्ट

इस सर्वर द्वारा कोई परिभाषित नहीं।

कैशिंग व्यवहार

table_overview और db_overview उपकरण उत्पन्न अवलोकन पाठ को संग्रहीत करने के लिए इन-मेमोरी कैश का उपयोग करते हैं।
कैश कुंजी (database_name, table_name) का एक टपल है।
जब table_overview कॉल किया जाता है, तो यह पहले कैश की जाँच करता है। यदि कोई परिणाम मौजूद है और refresh पैरामीटर false (डिफ़ॉल्ट) है, तो कैश्ड परिणाम तुरंत लौटा दिया जाता है। अन्यथा, यह StarRocks से डेटा प्राप्त करता है, इसे कैश में संग्रहीत करता है, और फिर इसे लौटाता है।
जब db_overview कॉल किया जाता है, तो यह डेटाबेस में सभी तालिकाओं को सूचीबद्ध करता है और फिर table_overview के समान कैशिंग तर्क का उपयोग करके प्रत्येक तालिका के लिए अवलोकन प्राप्त करने का प्रयास करता है (पहले कैश की जाँच करना, यदि आवश्यक हो तो प्राप्त करना और refresh false है या कैश मिस है)। यदि refresh db_overview के लिए true है, तो यह उस डेटाबेस की सभी तालिकाओं के लिए एक रिफ्रेश बाध्य करता है।
STARROCKS_OVERVIEW_LIMIT पर्यावरण चर कैश को पॉप्युलेट करते समय प्रति तालिका उत्पन्न अवलोकन स्ट्रिंग की अधिकतम लंबाई के लिए एक सॉफ्ट लक्ष्य प्रदान करता है, जो मेमोरी उपयोग को प्रबंधित करने में मदद करता है।
कैश्ड परिणाम, मूल प्राप्ति के दौरान आई किसी भी त्रुटि संदेश सहित, संग्रहीत किए जाते हैं और बाद के कैश हिट पर लौटाए जाते हैं।

डीबग

MCP सर्वर प्रारंभ करने के बाद, आप डीबग करने के लिए इंस्पेक्टर का उपयोग कर सकते हैं:

npx @modelcontextprotocol/inspector

डेमो

MCP Demo Image