Couchbase

Couchbase MCP सर्वर

Couchbase MCP सर्वर एक स्व-होस्टेड MCP सर्वर है जो AI एजेंटों को Couchbase क्लस्टरों में डेटा से जुड़ने और उसके साथ इंटरैक्ट करने की अनुमति देता है, चाहे वे Capella पर होस्ट किए गए हों या स्व-प्रबंधित हों। यह क्लस्टर स्वास्थ्य, डेटा स्कीमा, की-वैल्यू, क्वेरी और प्रदर्शन सहित श्रेणियों में उपकरण प्रदान करता है — केवल-पढ़ने के मोड और सूक्ष्म उपकरण अक्षम करने के माध्यम से सुरक्षा नियंत्रण के साथ। यह STDIO और स्ट्रीमेबल HTTP दोनों परिवहनों का समर्थन करता है।

Couchbase MCP सर्वर को Python Package Index (PyPI) पैकेज और Docker के माध्यम से वितरित किया जाता है। Couchbase MCP सर्वर के लिए एंटरप्राइज़ समर्थन Couchbase AI Data Plane के लाइसेंस के माध्यम से उपलब्ध है, जो Couchbase Agent Memory और Couchbase Agent Catalog के उपयोग और एंटरप्राइज़ समर्थन का भी अधिकार देता है।

पूर्ण दस्तावेज़ीकरण के लिए, mcp-server.couchbase.com पर जाएँ।

सुविधाएँ/उपकरण

क्लस्टर सेटअप और स्वास्थ्य उपकरण

डेटा मॉडल और स्कीमा खोज उपकरण

दस्तावेज़ KV संचालन उपकरण

क्वेरी और अनुक्रमण उपकरण

क्वेरी प्रदर्शन विश्लेषण उपकरण

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

• Python 3.10 या उच्चतर।
• एक चालू Couchbase क्लस्टर। आरंभ करने का सबसे आसान तरीका Capella मुफ़्त स्तर का उपयोग करना है, जो Couchbase सर्वर का पूरी तरह से प्रबंधित संस्करण है। आप नमूना डेटासेट आयात करने या अपना स्वयं का आयात करने के लिए निर्देशों का पालन कर सकते हैं।
• सर्वर चलाने के लिए uv स्थापित।
• सर्वर को Claude से जोड़ने के लिए एक MCP क्लाइंट जैसे Claude Desktop स्थापित। निर्देश Claude Desktop और Cursor के लिए प्रदान किए गए हैं। अन्य MCP क्लाइंट का भी उपयोग किया जा सकता है।

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

MCP सर्वर को पूर्व-निर्मित PyPI पैकेज या uv का उपयोग करके स्रोत से चलाया जा सकता है।

PyPI से चलाना

हम MCP सर्वर के लिए एक पूर्व-निर्मित PyPI पैकेज प्रकाशित करते हैं।

MCP क्लाइंट के लिए पूर्व-निर्मित पैकेज का उपयोग करके सर्वर कॉन्फ़िगरेशन

मूल प्रमाणीकरण

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

या

mTLS

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_CLIENT_CERT_PATH": "/path/to/client-certificate.pem",
        "CB_CLIENT_KEY_PATH": "/path/to/client.key"
      }
    }
  }
}

नोट: यदि आपके पास क्लाइंट में अन्य MCP सर्वर उपयोग में हैं, तो आप इसे मौजूदा mcpServers ऑब्जेक्ट में जोड़ सकते हैं।

स्रोत से चलाना

MCP सर्वर को इस रिपॉजिटरी का उपयोग करके स्रोत से चलाया जा सकता है।

रिपॉजिटरी को अपनी स्थानीय मशीन पर क्लोन करें

git clone https://github.com/couchbase/mcp-server-couchbase.git

MCP क्लाइंट के लिए स्रोत का उपयोग करके सर्वर कॉन्फ़िगरेशन

यह MCP क्लाइंट जैसे Claude Desktop, Cursor, Windsurf Editor के लिए सामान्य कॉन्फ़िगरेशन है।

{
  "mcpServers": {
    "couchbase": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/repo/mcp-server-couchbase/",
        "run",
        "src/mcp_server.py"
      ],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

नोट: path/to/cloned/repo/mcp-server-couchbase/ आपकी स्थानीय मशीन पर क्लोन की गई रिपॉजिटरी का पथ होना चाहिए। अंत में अनुगामी स्लैश न भूलें!

नोट: यदि आपके पास क्लाइंट में अन्य MCP सर्वर उपयोग में हैं, तो आप इसे मौजूदा mcpServers ऑब्जेक्ट में जोड़ सकते हैं।

MCP सर्वर के लिए अतिरिक्त कॉन्फ़िगरेशन

सर्वर को पर्यावरण चर या कमांड लाइन तर्कों का उपयोग करके कॉन्फ़िगर किया जा सकता है:

केवल-पढ़ने का मोड कॉन्फ़िगरेशन

CB_MCP_READ_ONLY_MODE लेखन संचालन को नियंत्रित करने वाला एकल स्विच है:

• जब true (डिफ़ॉल्ट): सभी लेखन संचालन (KV और क्वेरी) अक्षम हैं। KV लेखन उपकरण (अपसर्ट, इंसर्ट, रिप्लेस, डिलीट) लोड नहीं होते हैं और LLM के लिए उपलब्ध नहीं होंगे, और डेटा या संरचना को संशोधित करने वाली SQL++ क्वेरीज़ अवरुद्ध हैं।
• जब false: KV लेखन उपकरण लोड होते हैं और SQL++ डेटा/संरचना संशोधन क्वेरीज़ की अनुमति है।

LLM द्वारा अनजाने डेटा संशोधनों को रोकने के लिए यह अनुशंसित सुरक्षित डिफ़ॉल्ट है।

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

उपकरण अक्षम करना

आप विशिष्ट उपकरणों को लोड होने और MCP क्लाइंट के सामने आने से रोकने के लिए उन्हें अक्षम कर सकते हैं। अक्षम उपकरण उपकरण खोज में दिखाई नहीं देंगे और LLM द्वारा लागू नहीं किए जा सकते।

समर्थित प्रारूप

अल्पविराम से अलग की गई सूची:

# Environment variable
CB_MCP_DISABLED_TOOLS="upsert_document_by_id, delete_document_by_id"

# Command line
uvx couchbase-mcp-server --disabled-tools upsert_document_by_id, delete_document_by_id

फ़ाइल पथ (प्रति पंक्ति एक उपकरण नाम):

# Environment variable
CB_MCP_DISABLED_TOOLS=disabled_tools.txt

# Command line
uvx couchbase-mcp-server --disabled-tools disabled_tools.txt

फ़ाइल प्रारूप (जैसे, disabled_tools.txt):

# Write operations
upsert_document_by_id
delete_document_by_id

# Index advisor
get_index_advisor_recommendations

# से शुरू होने वाली पंक्तियों को टिप्पणियों के रूप में माना जाता है और अनदेखा कर दिया जाता है।

MCP क्लाइंट कॉन्फ़िगरेशन उदाहरण

अल्पविराम से अलग की गई सूची का उपयोग करना:

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_MCP_DISABLED_TOOLS": "upsert_document_by_id,delete_document_by_id"
      }
    }
  }
}

फ़ाइल पथ का उपयोग करना (कई उपकरणों के लिए अनुशंसित):

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_MCP_DISABLED_TOOLS": "/path/to/disabled_tools.txt"
      }
    }
  }
}

महत्वपूर्ण सुरक्षा नोट

चेतावनी: केवल उपकरणों को अक्षम करने से यह गारंटी नहीं मिलती कि कुछ संचालन नहीं किए जा सकते। अंतर्निहित डेटाबेस उपयोगकर्ता की RBAC (भूमिका-आधारित अभिगम नियंत्रण) अनुमतियाँ आधिकारिक सुरक्षा नियंत्रण हैं।

उदाहरण के लिए, भले ही आप upsert_document_by_id और delete_document_by_id को अक्षम कर दें, डेटा संशोधन अभी भी run_sql_plus_plus_query उपकरण के माध्यम से SQL++ DML कथनों (INSERT, UPDATE, DELETE, MERGE) का उपयोग करके हो सकते हैं, जब तक कि:

• CB_MCP_READ_ONLY_MODE को true (डिफ़ॉल्ट) पर सेट न किया गया हो, या
• डेटाबेस उपयोगकर्ता के पास डेटा संशोधन के लिए आवश्यक RBAC अनुमतियाँ न हों

सर्वोत्तम अभ्यास: प्राथमिक सुरक्षा उपाय के रूप में हमेशा अपने Couchbase उपयोगकर्ता क्रेडेंशियल्स पर उपयुक्त RBAC अनुमतियाँ कॉन्फ़िगर करें। उपकरण अक्षम करने का उपयोग LLM व्यवहार को निर्देशित करने और आक्रमण सतह को कम करने के लिए एक अतिरिक्त परत के रूप में करें, न कि एकमात्र सुरक्षा नियंत्रण के रूप में।

उपकरण कॉल के लिए प्राप्ति/पुष्टिकरण

आप निष्पादन से पहले विशिष्ट उपकरणों के लिए स्पष्ट उपयोगकर्ता पुष्टि की आवश्यकता कर सकते हैं (जब MCP क्लाइंट प्राप्ति का समर्थन करता है)।

CB_MCP_CONFIRMATION_REQUIRED_TOOLS / --confirmation-required-tools इन प्रारूपों का समर्थन करता है:

• अल्पविराम से अलग की गई सूची
• फ़ाइल पथ (प्रति पंक्ति एक उपकरण नाम, # टिप्पणियाँ समर्थित)

उदाहरण:

# Environment variable
CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"

# Command line
uvx couchbase-mcp-server --confirmation-required-tools delete_document_by_id,replace_document_by_id

जब कोई सूचीबद्ध उपकरण लागू किया जाता है:

• यदि क्लाइंट प्राप्ति का समर्थन करता है, तो उपयोगकर्ता को पुष्टि करने के लिए कहा जाता है।
• यदि क्लाइंट प्राप्ति का समर्थन नहीं करता है, तो उपकरण पश्चगामी संगतता के लिए बिना पुष्टि के निष्पादित होता है।

आप इसका उपयोग करके सर्वर का संस्करण भी जाँच सकते हैं:

uvx couchbase-mcp-server --version

लॉगिंग

MCP सर्वर डिफ़ॉल्ट रूप से stderr पर लॉग करता है। लॉगिंग को अतिरिक्त कॉन्फ़िगरेशन में सूचीबद्ध CB_MCP_LOG_* चर के साथ कॉन्फ़िगर किया गया है:

• CB_MCP_LOG_LEVEL — कितना लॉग किया जाता है: info (डिफ़ॉल्ट) जीवनचक्र घटनाओं और उपकरण आह्वानों को लॉग करता है, debug विस्तृत आंतरिक विवरण जोड़ता है, और off सभी लॉगिंग अक्षम करता है।
• CB_MCP_LOG_SINKS — लॉग कहाँ जाते हैं: stderr (डिफ़ॉल्ट), प्रति-स्तर घूर्णन फ़ाइलें (file), या दोनों। file के साथ, CB_MCP_LOG_FILE द्वारा निर्धारित पथ पर प्रति स्तर एक फ़ाइल लिखी जाती है (उदाहरण के लिए mcp_server.info.log और mcp_server.error.log)।

# Enable debug logging to both stderr and rotating per-level files
uvx couchbase-mcp-server --log-level=debug --log-sinks=stderr,file

अधिक विवरण के लिए, दस्तावेज़ीकरण देखें।

क्लाइंट विशिष्ट कॉन्फ़िगरेशन

स्ट्रीमेबल HTTP ट्रांसपोर्ट मोड

MCP सर्वर को स्ट्रीमेबल HTTP ट्रांसपोर्ट मोड में चलाया जा सकता है जो कई क्लाइंट को HTTP के माध्यम से एक ही सर्वर इंस्टेंस से कनेक्ट करने की अनुमति देता है। इस मोड में MCP सर्वर से कनेक्ट करने का प्रयास करने से पहले जाँच लें कि आपका MCP क्लाइंट स्ट्रीमेबल HTTP ट्रांसपोर्ट का समर्थन करता है या नहीं।

नोट: इस ट्रांसपोर्ट पर OAuth 2.1 प्राधिकरण समर्थित है। OAuth 2.1 प्राधिकरण देखें। OAuth कॉन्फ़िगर किए बिना, HTTP समापन बिंदु अप्रमाणित है।

उपयोग

डिफ़ॉल्ट रूप से, MCP सर्वर पोर्ट 8000 पर चलेगा लेकिन इसे --port या CB_MCP_PORT पर्यावरण चर का उपयोग करके कॉन्फ़िगर किया जा सकता है।

uvx couchbase-mcp-server \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --read-only-mode=true \
  --transport=http

सर्वर http://localhost:8000/mcp पर उपलब्ध होगा। इसका उपयोग Cursor जैसे स्ट्रीमेबल HTTP ट्रांसपोर्ट मोड का समर्थन करने वाले MCP क्लाइंट में किया जा सकता है।

MCP क्लाइंट कॉन्फ़िगरेशन

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

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

MCP सर्वर को सर्वर-प्रेषित ईवेंट (SSE) ट्रांसपोर्ट मोड में चलाने का विकल्प है।

नोट: SSE मोड को MCP द्वारा पदावनत कर दिया गया है। हमारे पास स्ट्रीमेबल HTTP के लिए समर्थन है।

SSE: उपयोग

डिफ़ॉल्ट रूप से, MCP सर्वर पोर्ट 8000 पर चलेगा लेकिन इसे --port या CB_MCP_PORT पर्यावरण चर का उपयोग करके कॉन्फ़िगर किया जा सकता है।

uvx couchbase-mcp-server \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --read-only-mode=true \
  --transport=sse

सर्वर http://localhost:8000/sse पर उपलब्ध होगा। इसका उपयोग Cursor जैसे SSE ट्रांसपोर्ट मोड का समर्थन करने वाले MCP क्लाइंट में किया जा सकता है।

SSE: MCP क्लाइंट कॉन्फ़िगरेशन

{
  "mcpServers": {
    "couchbase-sse": {
      "url": "http://localhost:8000/sse"
    }
  }
}

OAuth 2.1 प्राधिकरण

--transport=http के साथ चलने पर, MCP सर्वर एक OAuth 2.1 संसाधन सर्वर के रूप में कार्य कर सकता है: यह आपके पहचान प्रदाता के JWKS के विरुद्ध आने वाले वाहक JWT को मान्य करता है। यह प्रदाता-अज्ञेयवादी है (कोई भी OAuth 2.1 / OIDC प्रदाता जो JWKS प्रकाशित करता है — Auth0, Okta, Keycloak, AWS Cognito, Microsoft Entra, आदि) और टोकन जारी नहीं करता है या उपयोगकर्ताओं का प्रबंधन नहीं करता है। OAuth सेटिंग्स stdio पर अनदेखी की जाती हैं।

OAuth को अतिरिक्त कॉन्फ़िगरेशन में सूचीबद्ध CB_MCP_OAUTH_* चर के साथ कॉन्फ़िगर किया गया है:

• OAuth केवल तभी सक्रिय होता है जब CB_MCP_OAUTH_JWT_JWKS_URI, CB_MCP_OAUTH_JWT_ISSUER, और CB_MCP_OAUTH_JWT_AUDIENCE तीनों सेट हों; उनमें से केवल कुछ को सेट करना स्टार्टअप पर विफल हो जाता है।
• CB_MCP_OAUTH_MCP_BASE_URL सेट करने से अतिरिक्त रूप से RFC 9728 संरक्षित संसाधन मेटाडेटा प्रकाशित होता है ताकि PRM-जागरूक क्लाइंट प्राधिकरण सर्वर की खोज कर सकें।
• टोकन के scope/scp दावे से पढ़े गए दो स्कोप द्वारा पहुँच को नियंत्रित किया जाता है: couchbase-mcp:read (SQL++ सहित उपकरण पढ़ें) और couchbase-mcp:write (KV उत्परिवर्तन उपकरण)। पूर्ण पहुँच के लिए दोनों की आवश्यकता होती है।

uvx couchbase-mcp-server \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --transport=http \
  --oauth-jwks-uri='https://auth.example.com/.well-known/jwks.json' \
  --oauth-issuer='https://auth.example.com/' \
  --oauth-audience='couchbase-mcp-server' \
  --oauth-mcp-base-url='<public_base_url_of_this_server>'

पूर्ण विवरण के लिए, दस्तावेज़ीकरण देखें।

डॉकर छवि

MCP सर्वर को डॉकर कंटेनर के रूप में भी बनाया और चलाया जा सकता है। पूर्व-निर्मित छवियाँ DockerHub पर पाई जा सकती हैं या docker pull docker.io/couchbase/mcp-server:latest के माध्यम से खींची जा सकती हैं।

वैकल्पिक रूप से, हम डॉकर MCP कैटलॉग का हिस्सा हैं।

छवि बनाना

docker build -t mcp/couchbase-src .

docker build --build-arg GIT_COMMIT_HASH=$(git rev-parse HEAD) \
  --build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') \
  -t mcp/couchbase-src .

# Build with default image name (mcp/couchbase-src)
./build.sh

# Build with custom image name
./build.sh my-custom/image-name

# View git commit hash in image
docker inspect --format='{{index .Config.Labels "org.opencontainers.image.revision"}}' mcp/couchbase-src:latest

# View all metadata labels
docker inspect --format='{{json .Config.Labels}}' mcp/couchbase-src:latest

चलाना

MCP सर्वर को Couchbase सेटिंग्स कॉन्फ़िगर करने के लिए उपयोग किए जाने वाले पर्यावरण चर के साथ चलाया जा सकता है। पर्यावरण चर वही हैं जो अतिरिक्त कॉन्फ़िगरेशन अनुभाग में वर्णित हैं।

स्वतंत्र डॉकर कंटेनर

docker run --rm -i \
  -e CB_CONNECTION_STRING='<couchbase_connection_string>' \
  -e CB_USERNAME='<database_user>' \
  -e CB_PASSWORD='<database_password>' \
  -e CB_MCP_TRANSPORT='<http|sse|stdio>' \
  -e CB_MCP_READ_ONLY_MODE='<true|false>' \
  -e CB_MCP_CONFIRMATION_REQUIRED_TOOLS='delete_document_by_id' \
  -e CB_MCP_PORT=9001 \
  -e CB_MCP_HOST=0.0.0.0 \
  -p 9001:9001 \
  mcp/couchbase-src

CB_MCP_PORT और CB_MCP_HOST पर्यावरण चर केवल http और sse जैसे HTTP परिवहन मोड के मामले में लागू होते हैं।

डॉकर: MCP क्लाइंट कॉन्फ़िगरेशन

डॉकर छवि का उपयोग निम्नलिखित कॉन्फ़िगरेशन के साथ stdio परिवहन मोड में किया जा सकता है।

{
  "mcpServers": {
    "couchbase-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CB_CONNECTION_STRING=<couchbase_connection_string>",
        "-e",
        "CB_USERNAME=<database_user>",
        "-e",
        "CB_PASSWORD=<database_password>",
        "mcp/couchbase-src"
      ]
    }
  }
}

नोट्स

• couchbase_connection_string मान इस बात पर निर्भर करता है कि Couchbase सर्वर उसी होस्ट मशीन पर, किसी अन्य डॉकर कंटेनर में, या किसी दूरस्थ होस्ट पर चल रहा है। यदि आपका Couchbase सर्वर आपकी होस्ट मशीन पर चल रहा है, तो आपका कनेक्शन स्ट्रिंग संभवतः couchbase://host.docker.internal के रूप का होगा। विवरण के लिए डॉकर दस्तावेज़ीकरण देखें।
• आप --network=<your_network> विकल्प का उपयोग करके कंटेनर की नेटवर्किंग निर्दिष्ट कर सकते हैं। आपके द्वारा चुना गया नेटवर्क आपके पर्यावरण पर निर्भर करता है; डिफ़ॉल्ट bridge है। विवरण के लिए, डॉकर में नेटवर्क ड्राइवर देखें।

LLM से जुड़े जोखिम

• बड़े भाषा मॉडल और समान तकनीक के उपयोग में जोखिम शामिल हैं, जिसमें गलत या हानिकारक आउटपुट की संभावना भी शामिल है।
• Couchbase ऐसे आउटपुट की गुणवत्ता या सटीकता की समीक्षा या मूल्यांकन नहीं करता है, और ऐसे आउटपुट Couchbase के विचारों को प्रतिबिंबित नहीं कर सकते हैं।
• बड़े भाषा मॉडल और संबंधित तकनीक का उपयोग करने का निर्णय लेने और किसी भी लाइसेंस शर्तों, उपयोग की शर्तों और आपके संगठन की नीतियों का अनुपालन करने के लिए आप पूरी तरह से जिम्मेदार हैं जो आपके उपयोग को नियंत्रित करती हैं।

समस्या निवारण युक्तियाँ

• यदि स्रोत से चल रहे हैं तो सुनिश्चित करें कि कॉन्फ़िगरेशन में आपके MCP सर्वर रिपॉजिटरी का पथ सही है।
• सत्यापित करें कि आपका Couchbase कनेक्शन स्ट्रिंग, डेटाबेस उपयोगकर्ता नाम, पासवर्ड या प्रमाणपत्रों का पथ सही है।
• यदि Couchbase Capella का उपयोग कर रहे हैं, तो सुनिश्चित करें कि क्लस्टर उस मशीन से सुलभ है जहाँ MCP सर्वर चल रहा है।
• जाँचें कि डेटाबेस उपयोगकर्ता के पास कम से कम एक बकेट तक पहुँचने की उचित अनुमतियाँ हैं।
• पुष्टि करें कि uv पैकेज मैनेजर ठीक से स्थापित और सुलभ है। आपको कॉन्फ़िगरेशन में command फ़ील्ड में uv/uvx का पूर्ण पथ प्रदान करने की आवश्यकता हो सकती है।
• किसी भी त्रुटि या चेतावनी के लिए लॉग जाँचें जो MCP सर्वर के साथ समस्याओं का संकेत दे सकती हैं। लॉग का स्थान आपके MCP क्लाइंट पर निर्भर करता है।
• यदि आप अपने स्थानीय MCP सर्वर रिपॉजिटरी को अपडेट करने के बाद स्रोत से अपना MCP सर्वर चलाने में समस्याएँ देख रहे हैं, तो निर्भरताओं को अपडेट करने के लिए uv sync चलाने का प्रयास करें।

एकीकरण परीक्षण

हम यह सत्यापित करने के लिए उच्च-स्तरीय MCP एकीकरण परीक्षण प्रदान करते हैं कि सर्वर अपेक्षित उपकरणों को उजागर करता है और उन्हें एक डेमो Couchbase क्लस्टर के विरुद्ध लागू किया जा सकता है।

1. डेमो क्लस्टर क्रेडेंशियल निर्यात करें:
   • CB_CONNECTION_STRING
   • CB_USERNAME
   • CB_PASSWORD
   • वैकल्पिक: CB_MCP_TEST_BUCKET (परीक्षणों के दौरान जाँच करने के लिए एक बकेट)
2. परीक्षण चलाएँ:

uv run pytest tests/ -v

👩‍💻 योगदान

हम समुदाय से योगदान का स्वागत करते हैं! चाहे आप बग ठीक करना चाहते हों, सुविधाएँ जोड़ना चाहते हों, या दस्तावेज़ीकरण में सुधार करना चाहते हों, आपकी मदद की सराहना की जाती है।

यदि आपको सहायता चाहिए, कोई बग मिला है, या सुधारों में योगदान करना चाहते हैं, तो इसके लिए सबसे अच्छी जगह यहीं है — GitHub मुद्दा खोलकर।

डेवलपर्स के लिए

यदि आप कोड योगदान करने या विकास परिवेश स्थापित करने में रुचि रखते हैं:

📖 देखें CONTRIBUTING.md व्यापक डेवलपर सेटअप निर्देशों के लिए, जिनमें शामिल हैं:

• uv के साथ विकास परिवेश सेटअप
• Ruff के साथ कोड लिंटिंग और फ़ॉर्मेटिंग
• प्री-कमिट हुक स्थापना
• परियोजना संरचना अवलोकन
• विकास कार्यप्रवाह और अभ्यास

योगदानकर्ताओं के लिए त्वरित शुरुआत

# Clone and setup
git clone https://github.com/couchbase/mcp-server-couchbase.git
cd mcp-server-couchbase

# Install with development dependencies
uv sync --extra dev

# Install pre-commit hooks
uv run pre-commit install

# Run linting
./scripts/lint.sh

📢 समर्थन नीति

हम इस परियोजना में आपकी रुचि की वास्तव में सराहना करते हैं! यह परियोजना Couchbase समुदाय-अनुरक्षित है, जिसका अर्थ है कि यह हमारी समर्थन टीम द्वारा आधिकारिक रूप से समर्थित नहीं है। हालाँकि, हमारे इंजीनियर सक्रिय रूप से इस रिपो की निगरानी और रखरखाव कर रहे हैं और सर्वोत्तम प्रयास के आधार पर मुद्दों को हल करने का प्रयास करेंगे।

हमारा समर्थन पोर्टल इस परियोजना से संबंधित अनुरोधों में सहायता करने में असमर्थ है, इसलिए हम विनम्रतापूर्वक अनुरोध करते हैं कि सभी पूछताछ GitHub के भीतर ही रहें।

आपका सहयोग हम सभी को एक साथ आगे बढ़ने में मदद करता है — धन्यवाद!