Couchbase

Couchbase MCP Server

Couchbase MCP Server เป็น MCP Server แบบ self-hosted ที่อนุญาตให้ AI agent เชื่อมต่อและโต้ตอบกับข้อมูลใน Couchbase cluster ไม่ว่าจะโฮสต์บน Capella หรือแบบ self-managed โดยมีเครื่องมือในหมวดหมู่ต่างๆ เช่น Cluster Health, Data Schema, Key-Value, Query และ Performance — พร้อมการควบคุมความปลอดภัยผ่านโหมดอ่านอย่างเดียวและการปิดใช้งานเครื่องมือแบบละเอียด รองรับการขนส่งทั้งแบบ STDIO และ Streamable HTTP

Couchbase MCP server แจกจ่ายในรูปแบบแพ็คเกจ Python Package Index (PyPI) และผ่าน Docker การสนับสนุนระดับองค์กรสำหรับ Couchbase MCP Server มีให้ใช้งานโดยการขอใบอนุญาต Couchbase AI Data Plane ซึ่งให้สิทธิ์การใช้งานและการสนับสนุนระดับองค์กรสำหรับ Couchbase Agent Memory และ Couchbase Agent Catalog ด้วย

สำหรับเอกสารฉบับเต็ม โปรดเยี่ยมชม mcp-server.couchbase.com

คุณสมบัติ/เครื่องมือ

เครื่องมือตั้งค่าและตรวจสอบความสมบูรณ์ของคลัสเตอร์

เครื่องมือค้นหาโมเดลข้อมูลและสคีมา

เครื่องมือดำเนินการ KV ของเอกสาร

เครื่องมือคิวรีและดัชนี

เครื่องมือวิเคราะห์ประสิทธิภาพคิวรี

ข้อกำหนดเบื้องต้น

• Python 3.10 หรือสูงกว่า
• Couchbase cluster ที่กำลังทำงาน วิธีที่ง่ายที่สุดในการเริ่มต้นคือใช้ Capella แบบฟรีเทียร์ ซึ่งเป็นเวอร์ชันที่มีการจัดการเต็มรูปแบบของเซิร์ฟเวอร์ Couchbase คุณสามารถทำตาม คำแนะนำ เพื่อนำเข้าชุดข้อมูลตัวอย่างหรือนำเข้าข้อมูลของคุณเอง
• ติดตั้ง uv เพื่อรันเซิร์ฟเวอร์
• ติดตั้ง MCP client เช่น Claude Desktop เพื่อเชื่อมต่อเซิร์ฟเวอร์กับ Claude มีคำแนะนำสำหรับ Claude Desktop และ Cursor สามารถใช้ MCP client อื่นๆ ได้เช่นกัน

การกำหนดค่า

MCP server สามารถรันได้จากแพ็คเกจ PyPI ที่สร้างไว้ล่วงหน้าหรือจากซอร์สโดยใช้ uv

การรันจาก PyPI

เราเผยแพร่ แพ็คเกจ PyPI ที่สร้างไว้ล่วงหน้าสำหรับ MCP server

การกำหนดค่าเซิร์ฟเวอร์โดยใช้แพ็คเกจที่สร้างไว้ล่วงหน้าสำหรับ MCP Clients

การรับรองความถูกต้องแบบพื้นฐาน

{
  "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 server อื่นที่ใช้งานอยู่ใน client คุณสามารถเพิ่มลงในออบเจกต์ mcpServers ที่มีอยู่ได้

การรันจากซอร์ส

MCP server สามารถรันจากซอร์สโดยใช้ที่เก็บนี้

โคลนที่เก็บไปยังเครื่องของคุณ

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

การกำหนดค่าเซิร์ฟเวอร์โดยใช้ซอร์สสำหรับ MCP Clients

นี่คือการกำหนดค่าทั่วไปสำหรับ MCP clients เช่น 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 server อื่นที่ใช้งานอยู่ใน client คุณสามารถเพิ่มลงในออบเจกต์ mcpServers ที่มีอยู่ได้

การกำหนดค่าเพิ่มเติมสำหรับ MCP Server

เซิร์ฟเวอร์สามารถกำหนดค่าได้โดยใช้ตัวแปรสภาพแวดล้อมหรืออาร์กิวเมนต์บรรทัดคำสั่ง:

การกำหนดค่าโหมดอ่านอย่างเดียว

CB_MCP_READ_ONLY_MODE เป็นสวิตช์เดียวที่ควบคุมการดำเนินการเขียน:

• เมื่อ true (ค่าเริ่มต้น): การดำเนินการเขียนทั้งหมด (KV และ Query) จะถูกปิดใช้งาน เครื่องมือเขียน KV (upsert, insert, replace, delete) จะ ไม่ถูกโหลด และจะไม่พร้อมใช้งานสำหรับ LLM และคิวรี SQL++ ที่แก้ไขข้อมูลหรือโครงสร้างจะถูกบล็อก
• เมื่อ false: เครื่องมือเขียน KV จะถูกโหลดและอนุญาตให้ใช้คิวรี SQL++ ที่แก้ไขข้อมูล/โครงสร้าง

นี่คือค่าเริ่มต้นที่ปลอดภัยที่แนะนำเพื่อป้องกันการแก้ไขข้อมูลโดยไม่ได้ตั้งใจโดย LLM

หมายเหตุ: สำหรับการรับรองความถูกต้อง คุณต้องใช้ชื่อผู้ใช้และรหัสผ่าน หรือพาธ Client Certificate และ key หรือจะระบุพาธ CA root certificate ที่จะใช้ในการตรวจสอบใบรับรองเซิร์ฟเวอร์ก็ได้ หากระบุทั้งพาธ Client Certificate & key และชื่อผู้ใช้และรหัสผ่าน client certificates จะถูกใช้สำหรับการรับรองความถูกต้อง

การปิดใช้งานเครื่องมือ

คุณสามารถปิดใช้งานเครื่องมือเฉพาะเพื่อป้องกันไม่ให้ถูกโหลดและเปิดเผยต่อ MCP client เครื่องมือที่ถูกปิดใช้งานจะไม่ปรากฏในการค้นพบเครื่องมือและ 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 Client

การใช้รายการที่คั่นด้วยเครื่องหมายจุลภาค:

{
  "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 ที่จำเป็นสำหรับการแก้ไขข้อมูล

แนวทางปฏิบัติที่ดีที่สุด: กำหนดค่าสิทธิ์ RBAC ที่เหมาะสมบนข้อมูลประจำตัวผู้ใช้ Couchbase ของคุณเสมอเพื่อเป็นมาตรการรักษาความปลอดภัยหลัก ใช้การปิดใช้งานเครื่องมือเป็นชั้นเพิ่มเติมเพื่อชี้นำพฤติกรรมของ 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 จะมีการเขียนหนึ่งไฟล์ต่อระดับ (ตัวอย่างเช่น mcp_server.info.log และ mcp_server.error.log) ที่เส้นทางที่กำหนดโดย CB_MCP_LOG_FILE

# 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 ของคุณรองรับการขนส่ง HTTP แบบสตรีมได้ก่อนที่จะพยายามเชื่อมต่อกับเซิร์ฟเวอร์ MCP ในโหมดนี้

หมายเหตุ: รองรับการอนุญาต 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 ซึ่งสามารถใช้ในไคลเอนต์ MCP ที่รองรับโหมดการขนส่ง HTTP แบบสตรีมได้ เช่น Cursor

การกำหนดค่าไคลเอนต์ MCP

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

โหมดการขนส่ง SSE

มีตัวเลือกให้เรียกใช้เซิร์ฟเวอร์ MCP ในโหมดการขนส่ง Server-Sent Events (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 ซึ่งสามารถใช้ในไคลเอนต์ MCP ที่รองรับโหมดการขนส่ง SSE เช่น Cursor

SSE: การกำหนดค่าไคลเอนต์ MCP

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

การอนุญาต OAuth 2.1

เมื่อทำงานกับ --transport=http เซิร์ฟเวอร์ MCP สามารถทำหน้าที่เป็น เซิร์ฟเวอร์ทรัพยากร OAuth 2.1: จะตรวจสอบความถูกต้องของ JWT แบบ bearer ที่เข้ามากับ JWKS ของผู้ให้บริการข้อมูลประจำตัวของคุณ โดยไม่ขึ้นอยู่กับผู้ให้บริการ (ผู้ให้บริการ 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>'

สำหรับรายละเอียดทั้งหมด โปรดดู เอกสาร

อิมเมจ Docker

เซิร์ฟเวอร์ MCP ยังสามารถสร้างและเรียกใช้เป็นคอนเทนเนอร์ Docker ได้ สามารถพบอิมเมจที่สร้างไว้ล่วงหน้าได้บน DockerHub หรือดึงผ่าน docker pull docker.io/couchbase/mcp-server:latest

อีกทางหนึ่ง เราเป็นส่วนหนึ่งของ Docker MCP Catalog

การสร้างอิมเมจ

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 แบบอิสระ

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 เช่น http และ sse

Docker: การกำหนดค่าไคลเอนต์ MCP

อิมเมจ Docker สามารถใช้ในโหมดการขนส่ง 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 กำลังทำงานบนเครื่องโฮสต์เดียวกัน ในคอนเทนเนอร์ Docker อื่น หรือบนโฮสต์ระยะไกล หากเซิร์ฟเวอร์ Couchbase ของคุณกำลังทำงานบนเครื่องโฮสต์ของคุณ สตริงการเชื่อมต่อของคุณน่าจะอยู่ในรูปแบบ couchbase://host.docker.internal สำหรับรายละเอียด โปรดดู เอกสารประกอบ docker
• คุณสามารถระบุเครือข่ายของคอนเทนเนอร์ได้โดยใช้ตัวเลือก --network=<your_network> เครือข่ายที่คุณเลือกขึ้นอยู่กับสภาพแวดล้อมของคุณ ค่าเริ่มต้นคือ bridge สำหรับรายละเอียด โปรดดู ไดรเวอร์เครือข่ายใน docker

ความเสี่ยงที่เกี่ยวข้องกับ LLM

• การใช้โมเดลภาษาขนาดใหญ่และเทคโนโลยีที่คล้ายคลึงกันมีความเสี่ยง รวมถึงโอกาสที่จะได้ผลลัพธ์ที่ไม่ถูกต้องหรือเป็นอันตราย
• Couchbase ไม่ได้ตรวจสอบหรือประเมินคุณภาพหรือความถูกต้องของผลลัพธ์ดังกล่าว และผลลัพธ์ดังกล่าวอาจไม่สะท้อนมุมมองของ Couchbase
• คุณมีหน้าที่รับผิดชอบแต่เพียงผู้เดียวในการตัดสินใจว่าจะใช้โมเดลภาษาขนาดใหญ่และเทคโนโลยีที่เกี่ยวข้องหรือไม่ และปฏิบัติตามข้อกำหนดใบอนุญาต ข้อกำหนดการใช้งาน และนโยบายขององค์กรของคุณที่ควบคุมการใช้งานสิ่งเดียวกัน

เคล็ดลับการแก้ไขปัญหา

• ตรวจสอบให้แน่ใจว่าพาธไปยังที่เก็บเซิร์ฟเวอร์ MCP ของคุณถูกต้องในการกำหนดค่า หากรันจากซอร์ส
• ตรวจสอบว่าสตริงการเชื่อมต่อ Couchbase ชื่อผู้ใช้ฐานข้อมูล รหัสผ่าน หรือพาธไปยังใบรับรองของคุณถูกต้อง
• หากใช้ Couchbase Capella ตรวจสอบให้แน่ใจว่าคลัสเตอร์สามารถ เข้าถึงได้ จากเครื่องที่เซิร์ฟเวอร์ MCP กำลังทำงานอยู่
• ตรวจสอบว่าผู้ใช้ฐานข้อมูลมีสิทธิ์ที่เหมาะสมในการเข้าถึงอย่างน้อยหนึ่งบัคเก็ต
• ยืนยันว่าตัวจัดการแพ็คเกจ uv ได้รับการติดตั้งและเข้าถึงได้อย่างถูกต้อง คุณอาจต้องระบุพาธแบบสัมบูรณ์ไปยัง uv/uvx ในฟิลด์ command ในการกำหนดค่า
• ตรวจสอบบันทึกเพื่อหาข้อผิดพลาดหรือคำเตือนใดๆ ที่อาจบ่งบอกถึงปัญหากับเซิร์ฟเวอร์ 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 issue

สำหรับนักพัฒนา

หากคุณสนใจที่จะมีส่วนร่วมในการเขียนโค้ดหรือตั้งค่าสภาพแวดล้อมการพัฒนา:

📖 ดู CONTRIBUTING.md สำหรับคำแนะนำการตั้งค่านักพัฒนาที่ครอบคลุม รวมถึง:

• การตั้งค่าสภาพแวดล้อมการพัฒนาด้วย uv
• การตรวจสอบและจัดรูปแบบโค้ดด้วย Ruff
• การติดตั้ง pre-commit hooks
• ภาพรวมโครงสร้างโปรเจกต์
• ขั้นตอนการทำงานและแนวปฏิบัติในการพัฒนา

เริ่มต้นอย่างรวดเร็วสำหรับผู้มีส่วนร่วม

# 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 ซึ่งหมายความว่า ไม่ได้รับการสนับสนุนอย่างเป็นทางการ จากทีมสนับสนุนของเรา อย่างไรก็ตาม วิศวกรของเรากำลังติดตามและดูแล repo นี้อย่างแข็งขัน และจะพยายามแก้ไขปัญหาตามความสามารถที่ดีที่สุด

พอร์ทัลสนับสนุนของเราไม่สามารถให้ความช่วยเหลือเกี่ยวกับคำขอที่เกี่ยวข้องกับโปรเจกต์นี้ได้ ดังนั้นเราจึงขอให้สอบถามทั้งหมดอยู่ใน GitHub

การทำงานร่วมกันของคุณช่วยให้เราทุกคนก้าวไปข้างหน้าด้วยกัน — ขอบคุณ!