🏭 Camunda Engine MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Camunda Platform workflow engine. Provides 21 specialized tools for complete workflow automation and process management.

✅ PRODUCTION READY - Fully tested, containerized, and ready for deployment.

🚀 Quick Start

1. Start the Server

git clone <repo-url>
cd camunda-engine-mcp
docker-compose up -d

2. Configure Claude Desktop

Add to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "camunda": {
      "command": "docker",
      "args": [
        "exec", "-i",
        "-e", "CAMUNDA_BASE_URL=https://your-camunda-instance.com/engine-rest",
        "-e", "CAMUNDA_USERNAME=your-username",
        "-e", "CAMUNDA_PASSWORD=your-password",
        "camunda-mcp-server",
        "node", "build/index.js"
      ]
    }
  }
}

3. Restart Claude Desktop

Completely close and restart Claude Desktop to load the MCP server.

4. Test Connection

Try these commands in Claude Desktop:

Show me all available processes in Camunda

Get the list of current tasks from Camunda

Deploy BPMN from file /workspace/bpmn/simple-process.bpmn

🎯 Features

• 21 MCP Tools for complete Camunda workflow management
• Process Management - Deploy, start, monitor BPMN processes
• Task Management - Handle user tasks and forms
• Large File Support - Deploy big BPMN files via file paths
• Production Ready - Docker, monitoring, health checks
• Real-time Integration - Direct connection to live Camunda instances

📁 File Deployment

For large BPMN/form files, place them in directories:

./bpmn-files/your-process.bpmn    # → /workspace/bpmn/your-process.bpmn
./forms/your-form.form            # → /workspace/forms/your-form.form

Then use file paths instead of content:

Deploy BPMN from file /workspace/bpmn/your-process.bpmn

📚 Documentation

• [Setup Guide](SETUP_GUIDE.md) - Detailed configuration and all 21 tools
• [Troubleshooting](TROUBLESHOOTING.md) - Common issues and solutions
• [Testing Guide](TESTING_GUIDE.md) - Comprehensive testing framework
• [Production Report](PRODUCTION_READINESS_REPORT.md) - Production readiness details

🔧 Environment Variables

CAMUNDA_BASE_URL=https://your-camunda-instance.com/engine-rest
CAMUNDA_USERNAME=your-username
CAMUNDA_PASSWORD=your-password

🧪 Health Check

docker exec camunda-mcp-server npm run health-check

📞 Support

• Issues: Check Troubleshooting Guide
• Setup: See Setup Guide
• Testing: Run npm run health-check

Ready to automate your workflows with AI? Start with the Quick Start above! 🚀