What is Claudecode Orchestrator

ClaudeCode-Orchestrator is a Multi-Context Protocol (MCP) server designed to provide Claude.ai with specialized tools for code editing, formatting, reviewing, and context analysis using Server-Sent Events (SSE).

Use cases

Use cases include collaborative coding sessions, automated code formatting and reviewing, and providing context-aware suggestions during development.

How to use

To use ClaudeCode-Orchestrator, ensure you have Node.js and ngrok installed. Update the placeholder paths in the codebase with your actual paths, then run the server using the provided scripts for your operating system.

Key features

Key features include support for code editing, formatting, reviewing, and context analysis, all facilitated through SSE, allowing for real-time updates and interactions.

Where to use

ClaudeCode-Orchestrator can be used in software development environments, particularly where code collaboration and real-time editing are essential.

Claude Code Orchestrator

A Multi-Context Protocol (MCP) server that provides Claude.ai with specialized tools for code editing, formatting, reviewing, and context analysis through SSE (Server-Sent Events).

I also included the sequential thinking (https://github.com/spences10/mcp-sequentialthinking-tools) mcp sse as I use it. Feel free to not use it and remove it from the Orchestrator’s system prompt.

⚠️ Important: Path Configuration Required

This codebase has been prepared for open source release. ALL PATHS in the codebase are placeholders and must be updated with your actual paths before the server will run.

Prerequisites

• Node.js installed
• ngrok installed (download from https://ngrok.com) - its free
• Claude Pro/Team/Enterprise account with Integration access

Quick Start

# Windows
./start-all-simple.bat

# Linux/macOS
./start-all-simple.sh

Required Path Updates

Before running the server, you must update the following placeholder paths throughout the codebase:

TIP: easiest way to do this is using the built in search and replace tool in VSC. You can also ask claude code to make the changes for you.

1. Project Directory Path

• Placeholder: /path/to/project/directory
• Replace with: Your actual working directory where your projects are located
• Example: /home/username/projects or C:/Users/username/projects

2. Claude CLI Executable Path

• Placeholder: /path/to/claude/executable
• Replace with: Full path to your Claude CLI executable
• Example: /home/username/.nvm/versions/node/v22.15.0/bin/claude

3. Repository Root Path

• Placeholder: /path/to/cc-mcp
• Replace with: Full path to this repository on your system
• Example: /home/username/repos/cc-mcp or C:/Users/username/repos/cc-mcp

4. Node.js Bin Directory

• Placeholder: /path/to/node/bin
• Replace with: Path to your Node.js bin directory
• Example: /home/username/.nvm/versions/node/v22.15.0/bin

5. ngrok Executable

• Placeholder: ngrok (assumes it’s in your system PATH)
• Replace with: Full path to ngrok if it’s not in your PATH
• Example: C:/tools/ngrok/ngrok.exe

Files That Need Path Updates

You need to update paths in the following files:

Configuration Files

• simple-claude-code-mcp/claude-config-fix.json
• config.template.json (use as a template)

Batch Files (Windows)

• simple-claude-code-mcp/start-server.bat
• simple-claude-code-mcp/start-sse-server.bat
• simple-claude-code-mcp/start-sse-with-ngrok.bat
• mcp-sequentialthinking-tools/start-sse-server.bat
• mcp-sequentialthinking-tools/start-sse-with-ngrok.bat

Shell Scripts (Linux/macOS)

• simple-claude-code-mcp/start-server.sh
• simple-claude-code-mcp/start-sse-with-ngrok.sh
• mcp-sequentialthinking-tools/start-sse-with-ngrok.sh

PowerShell Scripts

• simple-claude-code-mcp/start-sse-with-ngrok.ps1
• mcp-sequentialthinking-tools/start-sse-with-ngrok.ps1

Source Code Files

• simple-claude-code-mcp/utils/claude-cli.js
• simple-claude-code-mcp/sse-server-claude.js

Environment Variables

Set these environment variables before running:

export CC_USER_DIRECTORY="/your/actual/project/directory"
export CLAUDE_EXECUTABLE_PATH="/your/actual/claude/executable/path"
export DEBUG="mcp:*"  # Optional: Enable debug logging

Installation

1. Clone the repository
2. Update all placeholder paths as described above
3. Install dependencies:

   npm install
   cd simple-claude-code-mcp && npm install
   cd ../mcp-sequentialthinking-tools && npm install && npm run build
   

Running the Server

The server runs via SSE (Server-Sent Events) and can be started with:

# Windows
./start-all-simple.bat

# Linux/macOS
./start-all-simple.sh

This will start both the Claude Code MCP server and the Sequential Thinking tools server.

Features

• Claude Code Tool: General-purpose code interaction
• Context Engine: Code context analysis
• Code Editor: Precise code editing
• Code Reviewer: Code review and analysis
• Code Formatter: Code formatting
• Sequential Thinking: Advanced problem-solving tools

Integration with Claude.ai

To use with Claude.ai:

1. Start the server using ./start-all-simple.bat
2. If you need external access, use ngrok:

   ngrok http 3000
   

3. Add the integration in Claude.ai:
   • Go to Settings → Integrations
   • Click “Add Integration”
   • Enter your server URL (local or ngrok)
   • Name it “Claude Code MCP”
   • Save

Troubleshooting

1. “Path not found” errors: Make sure you’ve updated ALL placeholder paths
2. “Command not found” errors: Ensure executables are in your PATH or use full paths
3. Permission errors: Make scripts executable with chmod +x script.sh
4. WSL issues: Ensure WSL is properly installed and configured

Security

See SECURITY.md for information about the security measures taken in preparing this codebase for open source release.

License

MIT License - see LICENSE file for details