Couchbase

Couchbase MCP Server, AI ajanlarının Capella veya kendi yönetilen Couchbase kümelerindeki verilere bağlanmasını ve bunlarla etkileşimde bulunmasını sağlayan, kendi kendine barındırılan bir MCP Server'dır. Küme Sağlığı, Veri Şeması, Anahtar-Değer, Sorgu ve Performans kategorilerinde araçlar sunar — salt okunur mod ve ayrıntılı araç devre dışı bırakma yoluyla güvenlik kontrolleri içerir. Hem STDIO hem de Streamable HTTP taşımacılığını destekler.

Couchbase MCP server, Python Package Index (PyPI) paketi ve Docker aracılığıyla dağıtılır. Couchbase MCP Server için kurumsal destek, Couchbase AI Data Plane lisansı alınarak edinilebilir; bu lisans aynı zamanda Couchbase Agent Memory ve Couchbase Agent Catalog kullanımı ve kurumsal desteğini de kapsar.

Tüm belgeler için mcp-server.couchbase.com adresini ziyaret edin.

Özellikler/Araçlar

Küme kurulumu ve sağlık araçları

Veri modeli ve şema keşfi araçları

Belge KV işlemleri araçları

Sorgu ve dizin oluşturma araçları

Sorgu performansı analiz araçları

Ön koşullar

• Python 3.10 veya üzeri.
• Çalışan bir Couchbase kümesi. Başlamanın en kolay yolu, tamamen yönetilen Couchbase sunucusu sürümü olan Capella ücretsiz katmanını kullanmaktır. Örnek veri kümelerinden birini içe aktarmak için talimatları izleyebilir veya kendi verilerinizi içe aktarabilirsiniz.
• Sunucuyu çalıştırmak için uv kurulu olmalıdır.
• Sunucuyu Claude'a bağlamak için Claude Desktop gibi bir MCP istemcisi kurulu olmalıdır. Talimatlar Claude Desktop ve Cursor için verilmiştir. Diğer MCP istemcileri de kullanılabilir.

Yapılandırma

MCP sunucusu, önceden oluşturulmuş PyPI paketinden veya kaynak kodundan uv kullanılarak çalıştırılabilir.

PyPI'dan Çalıştırma

MCP sunucusu için önceden oluşturulmuş bir PyPI paketi yayınlıyoruz.

MCP İstemcileri için Önceden Oluşturulmuş Paket Kullanarak Sunucu Yapılandırması

Temel Kimlik Doğrulama

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

veya

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"
      }
    }
  }
}

Not: İstemcide başka MCP sunucuları kullanıyorsanız, bunu mevcut mcpServers nesnesine ekleyebilirsiniz.

Kaynak Kodundan Çalıştırma

MCP sunucusu, bu depoyu kullanarak kaynak kodundan çalıştırılabilir.

Depoyu yerel makinenize kopyalayın

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

MCP İstemcileri için Kaynak Kullanarak Sunucu Yapılandırması

Bu, Claude Desktop, Cursor, Windsurf Editor gibi MCP istemcileri için ortak yapılandırmadır.

{
  "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"
      }
    }
  }
}

Not: path/to/cloned/repo/mcp-server-couchbase/, klonlanan deponun yerel makinenizdeki yolu olmalıdır. Sonundaki eğik çizgiyi unutmayın!

Not: İstemcide başka MCP sunucuları kullanıyorsanız, bunu mevcut mcpServers nesnesine ekleyebilirsiniz.

MCP Sunucusu için Ek Yapılandırma

Sunucu, ortam değişkenleri veya komut satırı bağımsız değişkenleri kullanılarak yapılandırılabilir:

Salt Okunur Mod Yapılandırması

CB_MCP_READ_ONLY_MODE yazma işlemlerini kontrol eden tek anahtardır:

• true (varsayılan) olduğunda: Tüm yazma işlemleri (KV, Query, scope/collection yönetimi ve index yönetimi) devre dışıdır. KV yazma araçları (upsert, insert, replace, delete, sub-document mutate), scope/collection yönetimi yazma araçları (create_scope, create_collection, delete_scope, delete_collection) ve index yazma araçları (create_index, build_index, drop_index) yüklenmez ve LLM için kullanılabilir olmaz; ayrıca veri veya yapıyı değiştiren SQL++ sorguları engellenir.
• false olduğunda: KV, scope/collection yönetimi ve index yazma araçları yüklenir ve SQL++ veri/yapı değişikliği sorgularına izin verilir.

Bu, LLM'ler tarafından yanlışlıkla veri değişikliği yapılmasını önlemek için önerilen güvenli varsayılandır.

Not: Kimlik doğrulama için Kullanıcı Adı ve Parola veya İstemci Sertifikası ve anahtar yollarından birine ihtiyacınız vardır. İsteğe bağlı olarak, sunucu sertifikalarını doğrulamak için kullanılacak CA kök sertifika yolunu belirtebilirsiniz. Hem İstemci Sertifikası & anahtar yolu hem de kullanıcı adı ve parola belirtilirse, kimlik doğrulama için istemci sertifikaları kullanılır.

Araçları Devre Dışı Bırakma

Belirli araçları, MCP istemcisine yüklenmesini ve sunulmasını önlemek için devre dışı bırakabilirsiniz. Devre dışı bırakılan araçlar araç keşfinde görünmez ve LLM tarafından çağrılamaz.

Desteklenen Biçimler

Virgülle ayrılmış liste:

# 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

Dosya yolu (her satırda bir araç adı):

# Environment variable
CB_MCP_DISABLED_TOOLS=disabled_tools.txt

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

Dosya biçimi (örn. disabled_tools.txt):

# Write operations
upsert_document_by_id
delete_document_by_id

# Index advisor
get_index_advisor_recommendations

# ile başlayan satırlar yorum olarak kabul edilir ve yok sayılır.

MCP İstemci Yapılandırma Örnekleri

Virgülle ayrılmış liste kullanarak:

{
  "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"
      }
    }
  }
}

Dosya yolu kullanarak (birçok araç için önerilir):

{
  "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"
      }
    }
  }
}

Önemli Güvenlik Notu

Uyarı: Yalnızca araçları devre dışı bırakmak, belirli işlemlerin gerçekleştirilemeyeceğini garanti etmez. Temel veritabanı kullanıcısının RBAC (Rol Tabanlı Erişim Kontrolü) izinleri yetkili güvenlik kontrolüdür.

Örneğin, upsert_document_by_id ve delete_document_by_id araçlarını devre dışı bıraksanız bile, run_sql_plus_plus_query aracı üzerinden SQL++ DML ifadeleri (INSERT, UPDATE, DELETE, MERGE) kullanılarak veri değişiklikleri yine de gerçekleşebilir, şu durumlar hariç:

• CB_MCP_READ_ONLY_MODE değeri true (varsayılan) olarak ayarlanmışsa, VEYA
• Veritabanı kullanıcısı veri değişikliği için gerekli RBAC izinlerine sahip değilse

En İyi Uygulama: Birincil güvenlik önlemi olarak Couchbase kullanıcı kimlik bilgilerinizde her zaman uygun RBAC izinlerini yapılandırın. Araç devre dışı bırakmayı, LLM davranışını yönlendirmek ve saldırı yüzeyini azaltmak için ek bir katman olarak kullanın; tek güvenlik kontrolü olarak değil.

Araç Çağrıları için Elicitation/Onay

Belirli araçlar için yürütmeden önce açık kullanıcı onayı isteyebilirsiniz (MCP istemcisi elicitation'ı destekliyorsa).

CB_MCP_CONFIRMATION_REQUIRED_TOOLS / --confirmation-required-tools şu biçimleri destekler:

• Virgülle ayrılmış liste
• Dosya yolu (her satırda bir araç adı, # yorumları desteklenir)

Örnek:

# 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

Listelenen bir araç çağrıldığında:

• İstemci elicitation'ı destekliyorsa, kullanıcıdan onay istenir.
• İstemci elicitation'ı desteklemiyorsa, geriye dönük uyumluluk için araç onay olmadan yürütülür.

Sunucunun sürümünü şu şekilde de kontrol edebilirsiniz:

uvx couchbase-mcp-server --version

Günlükleme

MCP sunucusu varsayılan olarak stderr hedefine günlük yazar. Günlükleme, Ek Yapılandırma bölümünde listelenen CB_MCP_LOG_* değişkenleriyle yapılandırılır:

• CB_MCP_LOG_LEVEL — ne kadar günlük tutulacağı: info (varsayılan) yaşam döngüsü olaylarını ve araç çağrılarını günlüğe kaydeder, debug ayrıntılı iç ayrıntıları ekler ve off tüm günlüklemeyi devre dışı bırakır.
• CB_MCP_LOG_SINKS — günlüklerin nereye gittiği: stderr (varsayılan), seviye başına dönen dosyalar (file) veya her ikisi. file ile, CB_MCP_LOG_FILE tarafından ayarlanan yolda her seviye için bir dosya yazılır (örneğin mcp_server.info.log ve mcp_server.error.log).
• Döndürme boyutu — CB_MCP_LOG_ROTATION_MAX_SIZE_MB, her seviye dosyasının döndüğü genel boyuttur (MB cinsinden). Bireysel seviyeleri CB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB (ERROR/WARNING/INFO/DEBUG) ile geçersiz kılın, ayrıca MB cinsinden, ayarlanmadığında genel değeri devralır. 0 boyutu (genel veya seviye başına) geçersizdir ve başlangıç uyarısıyla varsayılana (1 MB) döner. CB_MCP_LOG_MAX_BYTES (bayt) kullanımdan kaldırıldı ancak geriye dönük uyumluluk için hâlâ onurlandırılır; CB_MCP_LOG_ROTATION_MAX_SIZE_MB de ayarlandığında yok sayılır ve başlangıçta kullanımdan kaldırma uyarısı yazdırır.
• Saklama — CB_MCP_LOG_RETENTION_BACKUP_COUNT, seviye başına kaç döndürülmüş yedek tutulacağını ayarlar (canlı dosya hariç); 1 varsayılanı önceki davranışı korur. Bireysel seviyeleri CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNT (ERROR/WARNING/INFO/DEBUG) ile geçersiz kılın, ayarlanmadığında genel değeri devralır. Bir sayımı 0 olarak ayarlayın, o seviye için yalnızca canlı dosyayı tutun — yine de döndürme boyutuyla sınırlıdır (yedeklenmek yerine döndürmede sıfırlanır).
• Sunucu yapılandırma anlık görüntüsü — file hedefi etkin olduğunda, tek seferlik bir kayıt (OS, Python, bağımlılık sürümleri, taşıma, çözümlenmiş günlük yapılandırması ve gizlenmiş sunucu yapılandırması) JSON olarak özel bir mcp_server_config.log.json dosyasına yazılır (CB_MCP_LOG_FILE tabanından türetilir). Her başlangıçta üzerine yazılır, böylece destek her zaman güncel yapılandırmaya sahip olur ve dönen bir günlükten asla kaybolmaz.

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

# Keep 30 rotated ERROR backups but only the live DEBUG file
uvx couchbase-mcp-server --log-level=debug --log-sinks=file \
  --log-error-retention-backup-count=30 --log-debug-retention-backup-count=0

Daha fazla ayrıntı için belgelere bakın.

İstemciye Özel Yapılandırma

Akışkan HTTP Aktarım Modu

MCP Sunucusu, birden fazla istemcinin aynı sunucu örneğine HTTP üzerinden bağlanmasına olanak tanıyan Akışkan HTTP aktarım modunda çalıştırılabilir. Bu modda MCP sunucusuna bağlanmaya çalışmadan önce MCP istemcinizin akışkan http aktarımını destekleyip desteklemediğini kontrol edin.

Not: Bu aktarımda OAuth 2.1 yetkilendirmesi desteklenmektedir. OAuth 2.1 Yetkilendirmesine bakın. OAuth yapılandırılmadan HTTP uç noktası kimlik doğrulamasızdır.

Kullanım

Varsayılan olarak MCP sunucusu 8000 bağlantı noktasında çalışır, ancak bu, --port veya CB_MCP_PORT ortam değişkeni kullanılarak yapılandırılabilir.

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

Sunucu http://localhost:8000/mcp adresinde kullanılabilir olacaktır. Bu, Cursor gibi akışkan http aktarım modunu destekleyen MCP istemcilerinde kullanılabilir.

MCP İstemci Yapılandırması

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

SSE Aktarım Modu

MCP sunucusunu Sunucu Tarafı Olaylar (SSE) aktarım modunda çalıştırma seçeneği vardır.

Not: SSE modu MCP tarafından kullanımdan kaldırılmıştır. Akışkan HTTP desteğimiz bulunmaktadır.

SSE: Kullanım

Varsayılan olarak MCP sunucusu 8000 bağlantı noktasında çalışır, ancak bu, --port veya CB_MCP_PORT ortam değişkeni kullanılarak yapılandırılabilir.

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

Sunucu http://localhost:8000/sse adresinde kullanılabilir olacaktır. Bu, Cursor gibi SSE aktarım modunu destekleyen MCP istemcilerinde kullanılabilir.

SSE: MCP İstemci Yapılandırması

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

OAuth 2.1 Yetkilendirmesi

--transport=http ile çalıştırıldığında MCP sunucusu bir OAuth 2.1 kaynak sunucusu olarak hareket edebilir: gelen taşıyıcı JWT'leri kimlik sağlayıcınızın JWKS'ine karşı doğrular. Sağlayıcıdan bağımsızdır (JWKS yayınlayan herhangi bir OAuth 2.1 / OIDC sağlayıcısı — Auth0, Okta, Keycloak, AWS Cognito, Microsoft Entra vb.) ve belirteç vermez veya kullanıcıları yönetmez. OAuth ayarları stdio üzerinde yok sayılır.

OAuth, Ek Yapılandırma bölümünde listelenen CB_MCP_OAUTH_* değişkenleriyle yapılandırılır:

• OAuth yalnızca CB_MCP_OAUTH_JWT_JWKS_URI, CB_MCP_OAUTH_JWT_ISSUER ve CB_MCP_OAUTH_JWT_AUDIENCE üçü de ayarlandığında etkinleşir; yalnızca bazılarının ayarlanması başlangıçta başarısız olur.
• CB_MCP_OAUTH_MCP_BASE_URL ayarlandığında, PRM algılayan istemcilerin yetkilendirme sunucusunu keşfedebilmesi için RFC 9728 Korumalı Kaynak Meta Verileri de yayımlanır.
• Erişim, belirtecin scope/scp talebinden okunan iki kapsam tarafından denetlenir: couchbase-mcp:read (okuma araçları, SQL++ dahil) ve couchbase-mcp:write (yazma araçları: KV mutasyonları, kapsam/koleksiyon yönetimi ve dizin yönetimi). Tam erişim her ikisini de gerektirir. IdP'niz bu kurallı etiketleri yayamıyorsa, CB_MCP_OAUTH_SCOPE_READ_LABEL / CB_MCP_OAUTH_SCOPE_WRITE_LABEL ile geçersiz kılın.

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>'

Tüm ayrıntılar için dokümantasyona bakın.

Docker Görüntüsü

MCP sunucusu ayrıca bir Docker kapsayıcısı olarak derlenebilir ve çalıştırılabilir. Önceden derlenmiş görüntüler DockerHub üzerinde bulunabilir veya docker pull docker.io/couchbase/mcp-server:latest aracılığıyla çekilebilir.

Alternatif olarak, Docker MCP Kataloğu üyesiyiz.

Görüntü Derleme

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

Çalıştırma

MCP sunucusu, Couchbase ayarlarını yapılandırmak için ortam değişkenleri kullanılarak çalıştırılabilir. Ortam değişkenleri, Ek Yapılandırma bölümünde açıklananlarla aynıdır.

Bağımsız Docker Kapsayıcısı

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 ve CB_MCP_HOST ortam değişkenleri yalnızca http ve sse gibi HTTP aktarım modlarında geçerlidir.

Docker: MCP İstemci Yapılandırması

Docker görüntüsü, aşağıdaki yapılandırmayla stdio aktarım modunda kullanılabilir.

{
  "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"
      ]
    }
  }
}

Notlar

• couchbase_connection_string değeri, Couchbase sunucusunun ana makinede, başka bir Docker kapsayıcısında veya uzak bir ana bilgisayarda çalışıp çalışmadığına bağlıdır. Couchbase sunucunuz ana makinenizde çalışıyorsa, bağlantı dizeniz büyük olasılıkla couchbase://host.docker.internal biçiminde olacaktır. Ayrıntılar için docker dokümantasyonuna bakın.
• Kapsayıcının ağını --network=<your_network> seçeneğini kullanarak belirleyebilirsiniz. Seçeceğiniz ağ ortamınıza bağlıdır; varsayılan bridge'dir. Ayrıntılar için docker'da ağ sürücülerine bakın.

LLM'lerle İlişkili Riskler

• Büyük dil modellerinin ve benzer teknolojilerin kullanımı, yanlış veya zararlı çıktılar olasılığı da dahil olmak üzere riskler içerir.
• Couchbase, bu tür çıktıların kalitesini veya doğruluğunu incelemez veya değerlendirmez ve bu tür çıktılar Couchbase'in görüşlerini yansıtmayabilir.
• Büyük dil modellerini ve ilgili teknolojiyi kullanıp kullanmamaya karar vermek ve her türlü lisans koşuluna, kullanım koşullarına ve kuruluşunuzun bu kullanımı yöneten politikalarına uymak yalnızca sizin sorumluluğunuzdadır.

Kullanım Verisi Toplama

Bu ürün otomatik olarak kullanım ve performans verilerini (ürün adı ve sürümü gibi) ve tarayıcı bilgilerini (IP adresi gibi) toplar (toplu olarak "Kullanım Verileri"). Couchbase, Kullanım Verilerini, bize sağlayabileceğiniz diğer verilerle (kullanıcı adınız veya e-posta adresiniz gibi) birlikte ürünlerimizi geliştirmek ve iyileştirmek ve satış ve pazarlama programlarımızı bilgilendirmek için kullanır. Couchbase ürünlerinde sakladığınız hiçbir veriye erişmez veya toplamayız. Kullanım Verilerini, toplu kullanım kalıplarını anlamak ve ürünlerimizi sizin için daha kullanışlı hale getirmek için kullanırız. Couchbase'in bilgileri nasıl topladığı, koruduğu ve işlediği hakkında daha fazla bilgi için lütfen şu adreste görüntülenebilen Couchbase Gizlilik Politikasına başvurun: https://www.couchbase.com/privacy-policy.

Sorun Giderme İpuçları

• MCP sunucu deposunun yolunun, kaynaktan çalıştırıyorsanız yapılandırmada doğru olduğundan emin olun.
• Couchbase bağlantı dizenizin, veritabanı kullanıcı adınızın, parolanızın veya sertifikaların yolunun doğru olduğunu doğrulayın.
• Couchbase Capella kullanıyorsanız, kümenin MCP sunucusunun çalıştığı makineden erişilebilir olduğundan emin olun.
• Veritabanı kullanıcısının en az bir bucket'a erişmek için uygun izinlere sahip olduğunu kontrol edin.
• uv paket yöneticisinin düzgün şekilde kurulu ve erişilebilir olduğunu doğrulayın. Yapılandırmadaki command alanına uv/uvx için mutlak yol sağlamanız gerekebilir.
• MCP sunucusuyla ilgili sorunlara işaret edebilecek hatalar veya uyarılar için günlükleri kontrol edin. Günlüklerin konumu MCP istemcinize bağlıdır.
• Yerel MCP sunucu deponuzu güncelledikten sonra MCP sunucunuzu kaynaktan çalıştırırken sorunlar yaşıyorsanız, bağımlılıkları güncellemek için uv sync komutunu çalıştırmayı deneyin.

Entegrasyon testi

Sunucunun beklenen araçları açığa çıkardığını ve bu araçların demo bir Couchbase kümesine karşı çağrılabildiğini doğrulamak için üst düzey MCP entegrasyon testleri sağlıyoruz.

1. Demo küme kimlik bilgilerini dışa aktarın:
   • CB_CONNECTION_STRING
   • CB_USERNAME
   • CB_PASSWORD
   • İsteğe bağlı: CB_MCP_TEST_BUCKET (testler sırasında araştırılacak bir bucket)
2. Testleri çalıştırın:

uv run pytest tests/ -v

👩‍💻 Katkıda Bulunma

Topluluktan gelen katkıları memnuniyetle karşılıyoruz! Hataları düzeltmek, özellik eklemek veya belgeleri iyileştirmek istiyorsanız, yardımınız takdir edilir.

Yardıma ihtiyacınız varsa, bir hata bulduysanız veya iyileştirmelere katkıda bulunmak istiyorsanız, bunu yapmak için en iyi yer tam da burasıdır — bir GitHub sorunu açarak.

Geliştiriciler İçin

Kod katkısında bulunmak veya bir geliştirme ortamı kurmak istiyorsanız:

📖 Kapsamlı geliştirici kurulum talimatları için CONTRIBUTING.md dosyasına bakın, şunları içerir:

• uv ile geliştirme ortamı kurulumu
• Ruff ile kod linting ve biçimlendirme
• Pre-commit hook'larının kurulumu
• Proje yapısına genel bakış
• Geliştirme iş akışı ve uygulamaları

Katkıda Bulunanlar İçin Hızlı Başlangıç

# 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

📢 Destek Politikası

Bu projeye gösterdiğiniz ilgiyi içtenlikle takdir ediyoruz! Bu proje Couchbase topluluğu tarafından bakımı yapılmaktadır, yani destek ekibimiz tarafından resmi olarak desteklenmemektedir. Ancak mühendislerimiz bu depoyu aktif olarak izlemekte ve sürdürmektedir; sorunları en iyi çaba temelinde çözmeye çalışacaklardır.

Destek portalımız bu projeyle ilgili isteklere yardımcı olamamaktadır; bu nedenle tüm soruların GitHub içinde kalmasını rica ediyoruz.

İş birliğiniz hep birlikte ilerlememize yardımcı oluyor — teşekkürler!