Couchbase

Couchbase MCP Sunucusu

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

Couchbase MCP sunucusu, Python Package Index (PyPI) paketi olarak ve Docker aracılığıyla dağıtılır.
Couchbase MCP Sunucusu için kurumsal destek, Couchbase AI Data Plane lisansı ile sağlanır; bu lisans aynı zamanda Couchbase Agent Memory ve Couchbase Agent Catalog kullanımını ve kurumsal desteğini de içerir.

Tam dokümantasyon için docs.couchbase.com/mcp-server adresini ziyaret edin.

Özellikler/Araçlar

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

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

Belge KV işlem araçları

Sorgu ve dizinleme 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, Couchbase sunucusunun tamamen yönetilen sürümü olan Capella ücretsiz katmanını kullanmaktır. Örnek veri kümelerinden birini içe aktarmak için talimatları takip edebilir 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 sağlanmıştır. Diğer MCP istemcileri de kullanılabilir.

Yapılandırma

MCP sunucusu, önceden oluşturulmuş PyPI paketinden veya uv kullanarak kaynak koddan ç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 Koddan Çalıştırma

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

Depoyu yerel makinenize klonlayı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/, yerel makinenizdeki klonlanmış deponun yolu olmalıdır. Sondaki 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 olduğunda (varsayılan): 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 verileri 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ı ve 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ın yüklenmesini ve MCP istemcisine sunulmasını önlemek için bunları 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 ele alınır ve yok sayılır.

MCP İstemci Yapılandırma Örnekleri

Virgülle ayrılmış liste kullanma:

{ "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 kullanma (çok sayıda 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ı: Araçları tek başına 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, aşağıdaki durumlar olmadıkça run_sql_plus_plus_query aracı kullanılarak SQL++ DML ifadeleri (INSERT, UPDATE, DELETE, MERGE) aracılığıyla veri değişiklikleri yine de gerçekleşebilir:

• CB_MCP_READ_ONLY_MODE değeri true olarak ayarlanmışsa (varsayılan), 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'ı desteklediğinde).

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ü de şu şekilde kontrol edebilirsiniz:

uvx couchbase-mcp-server --version

Günlük Kaydı

MCP sunucusu varsayılan olarak stderr öğesine günlük kaydeder. Günlük kaydı, 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 kaydedildiği: info (varsayılan) yaşam döngüsü olaylarını ve araç çağrılarını kaydeder, debug ayrıntılı dahili ayrıntılar ekler ve off tüm günlük kaydını 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 seviye başına 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). Tek tek 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 geneli devralır. 0 boyutu (genel veya seviye başına) geçersizdir ve başlangıç uyarısıyla varsayılana (1 MB) geri döner. CB_MCP_LOG_MAX_BYTES (bayt) kullanımdan kaldırılmıştır 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üş yedeğin tutulacağını ayarlar (canlı dosya hariç); 1 varsayılanı önceki davranışı korur. Tek tek 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ıyı 0 olarak ayarlayın, o seviye için yalnızca canlı dosyayı tutmak üzere — 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 redakte edilmiş sunucu yapılandırması) adanmış bir mcp_server_config.log.json dosyasına JSON olarak 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 HTTP üzerinden aynı sunucu örneğine 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 desteklenir. OAuth 2.1 Yetkilendirmesi bölümüne bakın. OAuth yapılandırılmadıysa, HTTP uç noktası kimlik doğrulamasız olur.

Kullanım

Varsayılan olarak, MCP sunucusu 8000 portunda ç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ından Gönderilen 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 için desteğimiz vardır.

SSE: Kullanım

Varsayılan olarak, MCP sunucusu 8000 portunda ç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ışırken, MCP sunucusu bir OAuth 2.1 kaynak sunucusu olarak hareket edebilir: gelen taşıyıcı JWT'lerinizi 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ğişkenlerinin üçü de ayarlandığında etkinleşir; yalnızca bazılarını ayarlamak başlangıçta başarısız olur.
• CB_MCP_OAUTH_MCP_BASE_URL ayarının yapılması, PRM farkında istemcilerin yetkilendirme sunucusunu keşfedebilmesi için RFC 9728 Korumalı Kaynak Meta Verilerini de yayınlar.
• Erişim, belirtecin scope/scp iddiasından okunan iki kapsam tarafından kontrol edilir: couchbase-mcp:read (SQL++ dahil okuma araçları) ve couchbase-mcp:write (yazma araçları: KV mutasyonları, şema/koleksiyon yönetimi ve dizin yönetimi). Tam erişim her ikisini de gerektirir. Kimlik sağlayıcınız bu standart etiketleri yayamıyorsa, bunları 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>'

Tam ayrıntılar için belgelere 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 ile çekilebilir.

Alternatif olarak, Docker MCP Kataloğunun bir parçasıyız.

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ı durumunda 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 aynı ana makinede mi, başka bir Docker kapsayıcısında mı yoksa uzak bir ana bilgisayarda mı çalıştığı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 belgelerine bakın.
• Kapsayıcının ağını --network=<your_network> seçeneğini kullanarak belirtebilirsiniz. Seçtiğiniz ağ ortamınıza bağlıdır; varsayılan bridge'dur. 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ığı 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 bunların kullanımını yöneten lisans koşullarına, kullanım şartlarına ve kuruluşunuzun 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 (topluca "Kullanım Verileri"). Couchbase, Kullanım Verilerini, Couchbase'e 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 https://www.couchbase.com/privacy-policy. adresinde görüntülenebilen Couchbase Gizlilik Politikasına bakın.

Sorun Giderme İpuçları

• MCP sunucu deponuzun yolunun, kaynaktan çalıştırıyorsanız yapılandırmada doğru olduğundan emin olun.
• Couchbase bağlantı dizginizin, veritabanı kullanıcı adınızın, parolanızın veya sertifikalarınızı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 bucketa 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 bunların bir demo 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 yoklanacak 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, özellikler eklemek veya belgeleri iyileştirmek istiyor olsanız da yardımınız takdir edilmektedir.

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 burada — bir GitHub sorunu açarak.

Geliştiriciler İçin

Kod katkısında bulunmak veya bir geliştirme ortamı kurmakla ilgileniyorsanız:

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

• 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 olan ilginizi gerçekten takdir ediyoruz!
Bu proje Couchbase topluluğu tarafından bakımı yapılan bir projedir, yani destek ekibimiz tarafından resmi olarak desteklenmemektedir. Ancak mühendislerimiz bu depoyu aktif olarak izlemekte ve sürdürmektedir ve sorunları en iyi çaba temelinde çözmeye çalışacaktır.

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

İş birliğiniz hepimizin birlikte ilerlemesine yardımcı olur — teşekkürler!