Mcp Server Couchbase

🚀 Couchbase 语料服务器

Couchbase 语料服务器是一个支持多种操作系统的服务器，借助 Python 运行，能帮助用户高效管理和使用语料数据。通过简单的安装和配置，即可快速搭建并运行。

🚀 快速开始

安装要求

• 操作系统：支持 Linux、macOS 和 Windows。
• Python 版本：需要 Python 3.7 或更高版本。
• 依赖项：安装前请确保已安装 pip 和 uv。

操作步骤

1. 克隆仓库

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

2. 安装依赖项

   pip install -r requirements.txt
   

3. 运行服务器

   uv run src/mcp_server.py \
   --connection-string='' \
   --username='' \
   --password='' \
   --bucket-name=''
   

📦 安装指南

环境变量配置

通过设置以下环境变量来配置 Couchbase 连接信息：

• CB_CONNECTION_STRING：指定 Couchbase 集群连接字符串。
• CB_USERNAME：指定数据库用户名。
• CB_PASSWORD：指定数据库密码。
• CB_BUCKET_NAME：指定使用的桶名称。

传输协议

• 默认模式：使用标准输入输出（stdio）进行通信。
• 选择 SSE 模式

  uv run src/mcp_server.py --transport=sse
  

容器化运行

1. 构建 Docker 镜像

   docker build -t mcp/couchbase .
   

2. 运行容器

   docker run -i \
   -e CB_CONNECTION_STRING='' \
   -e CB_USERNAME='' \
   -e CB_PASSWORD='' \
   -e CB_BUCKET_NAME='' \
   mcp/couchbase
   

⚠️ 风险提示

⚠️ 重要提示

• 使用大型语言模型（LLM）可能涉及准确性或有害输出的风险。
• Couchbase 不审核或评估这些输出的质量或准确性，且这些输出不代表 Couchbase 的观点。
• 您需自行决定是否使用 LLM，并遵守相关许可条款和组织政策。

🛠️ 故障排除技巧

💡 使用建议

• 确保 MCP 服务器仓库路径在配置中正确无误。
• 验证 Couchbase 连接字符串、数据库用户名、密码和桶名称的准确性。
• 如果使用 Couchbase Capella，请确保集群可从运行 MCP 服务器的机器访问。
• 确认数据库用户具有访问指定桶的适当权限。
• 检查 uv 包管理器是否已正确安装且可用。可能需要在配置中的 command 字段提供 uv 的绝对路径。
• 查看日志以查找任何错误或警告信息，服务器日志位于 mcp-server-couchbase.log。

📄 支持政策

该项目由社区维护，并非官方支持。如需帮助或报告问题，请通过 GitHub 问题 提交。