Nuxeo MCP Server

A Model Context Protocol (MCP) server for interacting with a Nuxeo Content Repository Server. This server provides tools, resources, and prompt templates for AI assistants to interact with Nuxeo content repositories.

Features

• 🔄 Connect to a Nuxeo Content Repository Server
• 🛠️ MCP Tools for common Nuxeo operations (query, retrieve, create, update, delete documents)
• 🔍 Natural Language Search - convert plain English queries to NXQL automatically
• ⚡ NEW: Elasticsearch Passthrough - Natural language search via Elasticsearch with security filtering
• 🔐 NEW: Audit Log Search - Query audit logs using natural language (admin only)
• 🔒 NEW: OAuth2 Authentication - Secure browser-based authentication with token storage
• 📚 MCP Resources for accessing Nuxeo content
• 🧩 MCP Resource Templates for dynamic content access
• 📖 NXQL Guide Resource - comprehensive documentation for query syntax
• 🐳 Docker support for testing with a Nuxeo server
• 🧪 Comprehensive test suite with pytest

Requirements

• Python 3.10+
• Nuxeo Server (can be run via Docker)
• Docker (for testing)

Quick Start

Basic Authentication (Default)

# 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 Authentication (Recommended)

# 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

See the Authentication Guide for detailed OAuth2 setup instructions.

Documentation

• Authentication Guide - OAuth2 and authentication setup
• Developer Guide - How to build, run tests, and extend the project
• Usage Guide - How to use the MCP Server

Docker

Building the Docker Image

You can build a Docker image for the nuxeo-mcp server using the Dockerfile provided at the root of the project:

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

To build a x86 compatible image on a arm device:

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

Running the Docker Container

Once built, you can run the nuxeo-mcp server in a Docker container:

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

Environment Variables

You can configure the nuxeo-mcp server using environment variables:

Authentication Settings

# 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

Server Mode Configuration

The Docker container supports configurable server modes through environment variables:

• MCP_MODE: Server mode (sse or http, default: sse)
• MCP_PORT: Server port (default: 8181)
• MCP_HOST: Server host (default: 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

Configuring with Cline

To use the Nuxeo MCP server with Cline, you need to add a configuration to your Cline MCP settings file. See the Nuxeo MCP Server Configuration Examples for detailed examples of how to configure the server with different transport options.

The configuration file is typically located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Cline: ~/.config/cline/cline_mcp_settings.json or ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

License

This project is licensed under the MIT License.