Claude Parallel Tasks MCP Server

An MCP (Model Context Protocol) server that enables running multiple Claude prompts in parallel, with optional file contexts and output redirection.

Features

• Run multiple Claude prompts simultaneously in parallel
• Provide file contexts to Claude prompts
• Redirect output to individual files for each task
• Built with TypeScript and the MCP SDK

Prerequisites

• Node.js and pnpm
• Claude CLI tool installed and configured
• Anthropic API key

Setup

1. Clone the repository:

git clone https://github.com/CaptainCrouton89/claude-code-mcp.git
cd claude-code-mcp

2. Install dependencies:

pnpm install

3. Set up your environment variables:

cp .env.example .env.local

4. Edit .env.local and add your Anthropic API key:

ANTHROPIC_API_KEY=your_anthropic_api_key_here

5. Build the project:

pnpm run build

Usage

Running the Server

pnpm start

Configuring with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "claude-parallel": {
      "command": "node",
      "args": ["/path/to/claude-code-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_anthropic_api_key_here"
      }
    }
  }
}

Available Tools

run_parallel_claude_tasks

Runs multiple Claude prompts in parallel with optional file contexts.

Parameters:

• queries: Array of query objects, each containing:
  • queryText: The text prompt to send to Claude
  • contextFilePaths (optional): Array of file paths to provide as context

Example:

{
  "queries": [
    {
      "queryText": "Explain this code",
      "contextFilePaths": ["src/index.ts"]
    },
    {
      "queryText": "Write a summary of this project",
      "contextFilePaths": ["README.md", "package.json"]
    }
  ]
}

Development

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Run in development mode
pnpm run dev

Security

• API keys are stored in environment variables, not in code
• The .env.local file is gitignored to prevent accidental commits
• Use the provided .env.example as a template

License

MIT