Nuxeo MCP Server

MCP 服务器

用于与Nuxeo内容库服务器交互的模型上下文协议（MCP）服务器。此服务器为AI助手提供工具、资源和提示模板，以便与Nuxeo内容存储库进行交互。

特性

• 🔄 连接到Nuxeo内容存储库服务器
• 🛠️ 用于常见Nuxeo操作（查询、检索、创建、更新、删除文档）的MCP工具
• 🔍 自然语言搜索-将纯英语查询自动转换为NXQL
• ⚡ 新增：Elasticsearch直通 -通过带有安全过滤的Elasticsearch进行自然语言搜索
• 🔐 新增：审计日志搜索 -使用自然语言查询审计日志（仅限管理员）
• 🔒 新增：OAuth2身份验证 -使用令牌存储进行基于浏览器的安全身份验证
• 📚 用于访问Nuxeo内容的MCP资源
• 🧩 用于动态内容访问的MCP资源模板
• 📖 NXQL指南资源-查询语法的全面文档
• 🐳 Docker支持Nuxeo服务器测试
• 🧪 带pytest的全面测试套件

需求

• Python 3.10+
• Nuxeo服务器（可以通过Docker运行）
• Docker（用于测试）

快速开始

基本身份验证（默认）

# Start the MCP server with default settings
nuxeo-mcp

# With custom configuration
NUXEO_URL="http://mynuxeo.example.com/nuxeo" NUXEO_USERNAME="admin" NUXEO_PASSWORD="secret" nuxeo-mcp

OAuth2身份验证（推荐）

# Configure OAuth2 credentials
export NUXEO_URL="https://mynuxeo.example.com/nuxeo"
export NUXEO_OAUTH_CLIENT_ID="your-client-id"
export NUXEO_OAUTH_CLIENT_SECRET="your-client-secret"

# Start with OAuth2 (browser will open for authentication)
nuxeo-mcp --oauth2

# Or use environment variable
NUXEO_AUTH_METHOD=oauth2 nuxeo-mcp

请参阅 身份验证指南 有关OAuth2设置的详细说明。

文档

• 身份验证指南 -OAuth2和身份验证设置
• 开发者指南 -如何构建、运行测试和扩展项目
• 使用指南 -如何使用MCP服务器

码头工人

构建Docker镜像

您可以使用项目根目录下提供的Dockerfile为nuxeo-mcp服务器构建Docker镜像：

# Build the Docker image with the name nuxeo-mcp-server
docker build -t nuxeo-mcp-server .

要在arm设备上构建x86兼容映像，请执行以下操作：

docker buildx build --platform linux/amd64 -t nuxeo-mcp-server:latest .

运行Docker容器

构建完成后，您可以在Docker容器中运行nuxeo-mcp服务器：

# Run the container in SSE mode (default), exposing port 8181
docker run -p 8181:8181 --name nuxeo-mcp nuxeo-mcp-server

环境变量

您可以使用环境变量配置nuxeo mcp服务器：

验证设置

# Basic Authentication (default)
docker run -p 8181:8181 \
  -e NUXEO_URL="http://mynuxeo.example.com/nuxeo" \
  -e NUXEO_USERNAME="admin" \
  -e NUXEO_PASSWORD="secret" \
  nuxeo-mcp-server

# OAuth2 Authentication
docker run -p 8181:8181 \
  -e NUXEO_URL="https://mynuxeo.example.com/nuxeo" \
  -e NUXEO_AUTH_METHOD="oauth2" \
  -e NUXEO_OAUTH_CLIENT_ID="your-client-id" \
  -e NUXEO_OAUTH_CLIENT_SECRET="your-client-secret" \
  nuxeo-mcp-server

服务器模式配置

Docker容器通过环境变量支持可配置的服务器模式：

• MCP_MODE：服务器模式(sse 或 http，默认值： sse)
• MCP_PORT：服务器端口（默认值： 8181)
• MCP_HOST：服务器主机（默认值： 0.0.0.0)

# Run in HTTP mode
docker run -p 8181:8181 \
  -e MCP_MODE=http \
  --name nuxeo-mcp \
  nuxeo-mcp-server

# Run in SSE mode (default)
docker run -p 8181:8181 \
  -e MCP_MODE=sse \
  --name nuxeo-mcp \
  nuxeo-mcp-server

# Run on a different port
docker run -p 9000:9000 \
  -e MCP_PORT=9000 \
  --name nuxeo-mcp \
  nuxeo-mcp-server

使用Cline进行配置

要将Nuxeo MCP服务器与Cline一起使用，您需要将配置添加到Cline MCP设置文件中。请参阅 Nuxeo MCP服务器配置示例 有关如何使用不同传输选项配置服务器的详细示例。

配置文件通常位于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%/Claude/claude_desktop_config.json
• 克莱恩: ~/.config/cline/cline_mcp_settings.json 或 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

许可证

该项目根据MIT许可证获得许可。