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

Clone the repository:

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

Install dependencies:

pnpm install

Set up your environment variables:

cp .env.example .env.local

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

ANTHROPIC_API_KEY=your_anthropic_api_key_here

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