Coding Agent MCP Server

A comprehensive Model Context Protocol (MCP) server that provides coding agent capabilities including file operations, terminal commands, search functionality, and utility operations.

Features

🗂️ File Operations

Read/Write Files: Read file contents and write/overwrite files with encoding support
Advanced File Editing: Multiple editing methods including:
- String replacement with regex support
- Line-based editing with line numbers
- Character-based editing with precise positioning
- Diff-based editing (unified and XML formats)
File Management: Create, copy, move, and delete files
Directory Operations: List, create, and delete directories with recursive options

💻 Terminal Operations

Command Execution: Run terminal commands with working directory control
Real-time Streaming: Stream command output in real-time
Environment Management: Get and filter environment variables
Command Discovery: Find command paths (which/where functionality)
Timeout Control: Set execution timeouts for long-running commands

🔍 Search Operations

Text Search: Search for patterns in files with regex support
File Search: Find files by name patterns with glob support
Find & Replace: Bulk find and replace across multiple files
Duplicate Detection: Find duplicate files by content, name, or size
Advanced Options: Case sensitivity, whole word matching, context lines

🛠️ Utility Operations

Delays: Wait for specified time periods
System Information: Get detailed system and runtime information
UUID Generation: Generate UUIDs (v1 and v4)
Text Encoding: Base64, URL, and HTML encoding/decoding
Hashing: Generate hashes using MD5, SHA1, SHA256, SHA512
JSON Formatting: Format and validate JSON with key sorting
Regex Validation: Test and validate regular expressions
File Statistics: Calculate comprehensive file statistics

🛠️ Installation

Requirements

Node.js >= v18.0.0
Cursor, Windsurf, Claude Desktop or another MCP Client

Installing via Smithery

To install Coding Agent MCP Server for any client automatically via Smithery:

npx -y @smithery/cli@latest install coding-agent-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

You can find your Smithery key in the Smithery.ai webpage.

Install in Cursor

Go to: Settings → Cursor Settings → MCP → Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Alternative: Use Bun

{
  "mcpServers": {
    "coding-agent": {
      "command": "bunx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Alternative: Use Deno

{
  "mcpServers": {
    "coding-agent": {
      "command": "deno",
      "args": ["run", "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION", "--allow-net", "--allow-read", "--allow-write", "npm:coding-agent-mcp"]
    }
  }
}

Install in Windsurf

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Install in Trae

Use the Add manually feature and fill in the JSON configuration information for that MCP server. For more details, visit the Trae documentation.

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Install in VS Code

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

{
  "mcp": {
    "servers": {
      "coding-agent": {
        "type": "stdio",
        "command": "npx",
        "args": ["coding-agent-mcp"]
      }
    }
  }
}

Install in Visual Studio 2022

You can configure Coding Agent MCP in Visual Studio 2022 by following the Visual Studio MCP Servers documentation.

Add this to your Visual Studio MCP config file (see the Visual Studio docs for details):

{
  "mcp": {
    "servers": {
      "coding-agent": {
        "type": "stdio",
        "command": "npx",
        "args": ["coding-agent-mcp"]
      }
    }
  }
}

For more information and troubleshooting, refer to the Visual Studio MCP Servers documentation.

Install in Zed

Add this to your Zed settings.json. See Zed Context Server docs for more info.

{
  "context_servers": {
    "coding-agent": {
      "command": {
        "path": "npx",
        "args": ["coding-agent-mcp"]
      },
      "settings": {}
    }
  }
}

Install in Gemini CLI

See Gemini CLI Configuration for details.

Open the Gemini CLI settings file. The location is ~/.gemini/settings.json (where ~ is your home directory).
Add the following to the mcpServers object in your settings.json file:

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

If the mcpServers object does not exist, create it.

Install in Claude Code

Run this command. See Claude Code MCP docs for more info.

claude mcp add coding-agent -- npx coding-agent-mcp

Install in Claude Desktop

Add this to your Claude Desktop claude_desktop_config.json file. See Claude Desktop MCP docs for more info.

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Install in Cline

You can easily install Coding Agent through the Cline MCP Server Marketplace by following these instructions:

Open Cline.
Click the hamburger menu icon (☰) to enter the MCP Servers section.
Use the search bar within the Marketplace tab to find Coding Agent.
Click the Install button.

Alternatively, add this configuration to your Cline MCP settings:

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Install in BoltAI

Open the "Settings" page of the app, navigate to "Plugins," and enter the following JSON:

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Once saved, you can use the tools directly. More information is available on BoltAI's Documentation site. For BoltAI on iOS, see this guide.

Using Docker

If you prefer to run the MCP server in a Docker container:

Build the Docker Image:

First, create a Dockerfile in the project root (or anywhere you prefer):
Click to see Dockerfile content
```
FROM node:18-alpine

WORKDIR /app

# Install the latest version globally
RUN npm install -g coding-agent-mcp

# Expose default port if needed (optional, depends on MCP client interaction)
# EXPOSE 3000

# Default command to run the server
CMD ["coding-agent-mcp"]
```
Then, build the image using a tag (e.g., coding-agent-mcp). Make sure Docker Desktop (or the Docker daemon) is running. Run the following command in the same directory where you saved the Dockerfile:
```
docker build -t coding-agent-mcp .
```
Configure Your MCP Client:

Update your MCP client's configuration to use the Docker command.

Example for a cline_mcp_settings.json:
```
{
  "mcpServers": {
    "coding-agent": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "docker",
      "args": ["run", "-i", "--rm", "coding-agent-mcp"],
      "transportType": "stdio"
    }
  }
}
```
Note: This is an example configuration. Please refer to the specific examples for your MCP client (like Cursor, VS Code, etc.) earlier in this README to adapt the structure (e.g., mcpServers vs servers). Also, ensure the image name in args matches the tag used during the docker build command.

Install on Windows

The configuration on Windows is slightly different compared to Linux or macOS (Cline is used in the example). The same principle applies to other editors; refer to the configuration of command and args.

{
  "mcpServers": {
    "coding-agent": {
      "command": "cmd",
      "args": ["/c", "npx", "coding-agent-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Install in Augment Code

To configure Coding Agent MCP in Augment Code, you can use either the graphical interface or manual configuration.

A. Using the Augment Code UI

Click the hamburger menu.
Select Settings.
Navigate to the Tools section.
Click the + Add MCP button.
Enter the following command:
```
npx coding-agent-mcp
```
Name the MCP: Coding Agent.
Click the Add button.

Once the MCP server is added, you can start using Coding Agent's comprehensive coding features directly within Augment Code.

B. Manual Configuration

Press Cmd/Ctrl Shift P or go to the hamburger menu in the Augment panel
Select Edit Settings
Under Advanced, click Edit in settings.json
Add the server configuration to the mcpServers array in the augment.advanced object

"augment.advanced": {
  "mcpServers": [
    {
      "name": "coding-agent",
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  ]
}

Once the MCP server is added, restart your editor. If you receive any errors, check the syntax to make sure closing brackets or commas are not missing.

Install in Roo Code

Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Install in Zencoder

To configure Coding Agent MCP in Zencoder, follow these steps:

Go to the Zencoder menu (...)
From the dropdown menu, select Agent tools
Click on the Add custom MCP
Add the name and server configuration from below, and make sure to hit the Install button

{
  "command": "npx",
  "args": ["coding-agent-mcp"]
}

Once the MCP server is added, you can easily continue using it.

Install in Amazon Q Developer CLI

Add this to your Amazon Q Developer CLI configuration file. See Amazon Q Developer CLI docs for more details.

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Install in Qodo Gen

See Qodo Gen docs for more details.

Open Qodo Gen chat panel in VSCode or IntelliJ.
Click Connect more tools.
Click + Add new MCP.
Add the following configuration:

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Install in JetBrains AI Assistant

See JetBrains AI Assistant Documentation for more details.

In JetBrains IDEs go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Click + Add.
Click on Command in the top-left corner of the dialog and select the As JSON option from the list
Add this configuration and click OK

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

Click Apply to save changes.
The same way coding-agent could be added for JetBrains Junie in Settings → Tools → Junie → MCP Settings

Install in Warp

See Warp Model Context Protocol Documentation for details.

Navigate Settings > AI > Manage MCP servers.
Add a new MCP server by clicking the + Add button.
Paste the configuration given below:

{
  "coding-agent": {
    "command": "npx",
    "args": ["coding-agent-mcp"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Click Save to apply the changes.

Install in Opencode

Add this to your Opencode configuration file. See Opencode MCP docs docs for more info.

{
  "mcp": {
    "coding-agent": {
      "type": "local",
      "command": ["npx", "coding-agent-mcp"],
      "enabled": true
    }
  }
}

Install in Copilot Coding Agent

Using Coding Agent with Copilot Coding Agent

Add the following configuration to the mcp section of your Copilot Coding Agent configuration file Repository->Settings->Copilot->Coding agent->MCP configuration:

{
  "mcpServers": {
    "coding-agent": {
      "type": "stdio",
      "command": "npx",
      "args": ["coding-agent-mcp"]
    }
  }
}

For more information, see the official GitHub documentation.

Install in Kiro

See Kiro Model Context Protocol Documentation for details.

Navigate Kiro > MCP Servers
Add a new MCP server by clicking the + Add button.
Paste the configuration given below:

{
  "mcpServers": {
    "coding-agent": {
      "command": "npx",
      "args": ["coding-agent-mcp"],
      "env": {},
      "disabled": false,
      "autoApprove": [
        "read_file",
        "list_directory",
        "get_working_directory",
        "get_environment",
        "search_text",
        "search_files",
        "get_system_info"
      ]
    }
  }
}

Click Save to apply the changes.

Install in OpenAI Codex

See OpenAI Codex for more information.

Add the following configuration to your OpenAI Codex MCP server settings:

[mcp_servers.coding-agent]
args = ["coding-agent-mcp"]
command = "npx"

Install from Source

For development or custom builds:

git clone https://github.com/sukarth-acharya/coding-agent-mcp.git
cd coding-agent-mcp
npm install
npm run build
npm start

Or configure your MCP client to use the local build:

{
  "mcpServers": {
    "coding-agent": {
      "command": "node",
      "args": ["/path/to/coding-agent-mcp/dist/index.js"],
      "disabled": false
    }
  }
}

Available Tools

Total: 27 Tools across 4 categories

File Operations (10 tools)

read_file - Read file contents with encoding support
write_file - Write content to file (overwrites existing)
create_file - Create new file with optional content and overwrite protection
edit_file - Edit file using 4 methods (replace, line-numbers, character-match, diff)
delete_file - Delete a file safely
copy_file - Copy file to new location with overwrite control
move_file - Move/rename file with overwrite control
list_directory - List directory contents (recursive/non-recursive)
create_directory - Create directory with recursive option
delete_directory - Delete directory with recursive option

Terminal Operations (5 tools)

run_command - Execute terminal command with working directory and timeout control
run_command_stream - Execute command with real-time streaming output
get_environment - Get and filter environment variables
get_working_directory - Get current working directory
which_command - Find command path (cross-platform which/where)

Search Operations (4 tools)

search_text - Search for text patterns in files with regex, case sensitivity, context
search_files - Search for files by name pattern with glob support
find_and_replace - Bulk find and replace across files with dry-run mode
search_duplicates - Find duplicate files by content, name, or size

Utility Operations (8 tools)

delay - Wait for specified time (milliseconds or seconds)
get_system_info - Get system information (basic or detailed)
generate_uuid - Generate UUIDs (v1 and v4, single or multiple)
encode_decode - Encode/decode text (Base64, URL, HTML)
hash_text - Generate text hashes (MD5, SHA1, SHA256, SHA512)
format_json - Format and validate JSON with key sorting
validate_regex - Validate and test regular expressions
calculate_file_stats - Calculate comprehensive file statistics

File Editing Methods

The edit_file tool supports multiple editing approaches:

1. String Replace

{
  "method": "replace",
  "target": "old text",
  "replacement": "new text"
}

2. Line Numbers

{
  "method": "line-numbers",
  "startLine": 5,
  "endLine": 7,
  "replacement": "new content"
}

3. Character Matching

{
  "method": "character-match",
  "startChar": 100,
  "endChar": 150,
  "replacement": "new content"
}

4. Diff-based

{
  "method": "diff",
  "diffContent": "unified diff content",
  "diffFormat": "unified"
}

Performance & Limits

File Size: Handles files up to 10MB efficiently
Command Timeout: Default 30 seconds (configurable)
Search Results: Limited to 100 matches by default
Concurrent Operations: Optimized for single-threaded usage
Memory Usage: ~50MB typical, ~100MB peak

Development

Setup

git clone https://github.com/sukarth-acharya/coding-agent-mcp.git
cd coding-agent-mcp
npm install

Build

npm run build

Test

npm test
npm run test:watch  # Watch mode

Development Mode

npm run dev

📚 Development Usage Examples

Once installed, the MCP server provides 27 tools across 4 categories. Here are some practical examples of how you can use these tools in your code.

Note: The following examples show how MCP clients interact with the Coding Agent MCP server using the callTool function. These code samples are intended for use within an MCP client environment (such as Cursor, Kiro, Claude Desktop, etc.) that provides the callTool API. The MCP client handles all communication with the server automatically. These examples will not work in a regular Node.js script unless you have an MCP client SDK and the server properly set up.

🗂️ File Operations Examples

Reading and Writing Files

// Read a configuration file
await callTool('read_file', { 
  path: 'package.json',
  encoding: 'utf8'
});

// Create a new file with content
await callTool('create_file', {
  path: 'src/config.ts',
  content: 'export const API_URL = "https://api.example.com";',
  overwrite: false
});

// Write data to a file (overwrites existing)
await callTool('write_file', {
  path: 'output/results.json',
  content: JSON.stringify({ status: 'success', data: [] }, null, 2)
});

Advanced File Editing

// Replace all occurrences of a string
await callTool('edit_file', {
  path: 'src/constants.ts',
  method: 'replace',
  target: 'localhost:3000',
  replacement: 'production.example.com'
});

// Edit specific lines
await callTool('edit_file', {
  path: 'README.md',
  method: 'line-numbers',
  startLine: 15,
  endLine: 17,
  replacement: '## Updated Section\n\nThis content has been updated.'
});

// Precise character-based editing
await callTool('edit_file', {
  path: 'src/app.js',
  method: 'character-match',
  startChar: 245,
  endChar: 267,
  replacement: 'newFunctionName'
});

Directory Operations

// List directory contents recursively
await callTool('list_directory', {
  path: './src',
  recursive: true,
  includeHidden: false
});

// Create nested directories
await callTool('create_directory', {
  path: 'src/components/ui/buttons',
  recursive: true
});

// Copy files with overwrite protection
await callTool('copy_file', {
  source: 'template.config.js',
  destination: 'project.config.js',
  overwrite: false
});

💻 Terminal Operations Examples

Command Execution

// Run tests in a specific directory
await callTool('run_command', {
  command: 'npm test',
  workingDirectory: './my-project',
  timeout: 60000
});

// Install dependencies with environment variables
await callTool('run_command', {
  command: 'npm install',
  workingDirectory: './frontend',
  env: { NODE_ENV: 'development' }
});

// Stream long-running command output
await callTool('run_command_stream', {
  command: 'npm run build:watch',
  workingDirectory: './app',
  timeout: 300000
});

Environment and System Info

// Get Node.js related environment variables
await callTool('get_environment', {
  filter: 'NODE'
});

// Find where a command is located
await callTool('which_command', {
  command: 'git'
});

// Get current working directory
await callTool('get_working_directory', {});

🔍 Search Operations Examples

Text Search

// Find TODO comments in source code
await callTool('search_text', {
  pattern: 'TODO|FIXME|HACK',
  directory: './src',
  recursive: true,
  caseSensitive: false,
  contextLines: 2
});

// Search for function definitions
await callTool('search_text', {
  pattern: 'function\\s+\\w+\\(',
  directory: './lib',
  filePattern: '*.js',
  wholeWord: false,
  maxResults: 50
});

File Search

// Find all TypeScript files
await callTool('search_files', {
  pattern: '*.ts',
  directory: './src',
  recursive: true,
  type: 'file'
});

// Find configuration files
await callTool('search_files', {
  pattern: '*config*',
  directory: '.',
  includeHidden: true,
  maxResults: 20
});

Find and Replace

// Update import statements (dry run first)
await callTool('find_and_replace', {
  findPattern: 'import.*from [\'"]lodash[\'"]',
  replaceWith: 'import * as _ from "lodash"',
  directory: './src',
  filePattern: '*.ts',
  dryRun: true
});

// Replace API endpoints across the project
await callTool('find_and_replace', {
  findPattern: 'https://old-api.example.com',
  replaceWith: 'https://new-api.example.com',
  directory: './src',
  recursive: true,
  dryRun: false
});

Duplicate Detection

// Find duplicate files by content
await callTool('search_duplicates', {
  directory: './assets',
  method: 'content',
  recursive: true,
  minSize: 1024
});

// Find files with duplicate names
await callTool('search_duplicates', {
  directory: './src',
  method: 'name',
  filePattern: '*.js'
});

🛠️ Utility Operations Examples

Time and Delays

// Add a delay between operations
await callTool('delay', {
  seconds: 2
});

// Precise millisecond delay
await callTool('delay', {
  milliseconds: 1500
});

System Information

// Get basic system info
await callTool('get_system_info', {
  detailed: false
});

// Get detailed system information
await callTool('get_system_info', {
  detailed: true
});

Text Processing

// Generate UUIDs for database records
await callTool('generate_uuid', {
  version: 4,
  count: 5
});

// Encode sensitive data
await callTool('encode_decode', {
  text: 'sensitive-api-key',
  method: 'base64-encode'
});

// Generate file checksums
await callTool('hash_text', {
  text: 'file content here',
  algorithm: 'sha256',
  encoding: 'hex'
});

JSON and Regex

// Format and validate JSON
await callTool('format_json', {
  json: '{"name":"test","values":[1,2,3]}',
  indent: 2,
  sortKeys: true
});

// Test regex patterns
await callTool('validate_regex', {
  pattern: '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$',
  testString: '[email protected]',
  flags: 'i'
});$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',$',
  testString: '[email protected]',
  flags: 'i'
});

File Statistics

// Analyze project file statistics
await callTool('calculate_file_stats', {
  directory: './src',
  recursive: true,
  filePattern: '*'
});

🔄 Workflow Examples

Project Setup Automation

// 1. Create project structure
await callTool('create_directory', { path: 'my-app/src/components', recursive: true });
await callTool('create_directory', { path: 'my-app/tests', recursive: true });

// 2. Copy template files
await callTool('copy_file', { 
  source: 'templates/package.json', 
  destination: 'my-app/package.json' 
});

// 3. Install dependencies
await callTool('run_command', {
  command: 'npm install',
  workingDirectory: './my-app'
});

// 4. Run initial build
await callTool('run_command', {
  command: 'npm run build',
  workingDirectory: './my-app'
});

Code Refactoring

// 1. Find all files using old API
const searchResult = await callTool('search_text', {
  pattern: 'oldApiFunction',
  directory: './src',
  recursive: true
});

// 2. Replace with new API (dry run first)
await callTool('find_and_replace', {
  findPattern: 'oldApiFunction\\(',
  replaceWith: 'newApiFunction(',
  directory: './src',
  dryRun: true
});

// 3. Apply changes
await callTool('find_and_replace', {
  findPattern: 'oldApiFunction\\(',
  replaceWith: 'newApiFunction(',
  directory: './src',
  dryRun: false
});

// 4. Run tests to verify
await callTool('run_command', {
  command: 'npm test',
  workingDirectory: '.'
});

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Ensure all tests pass
Submit a pull request

License

MIT License - see LICENSE file for details.

Changelog

See CHANGELOG.md for detailed version history.

v1.0.0 - Latest

✅ 27 tools across 4 categories
✅ 48 comprehensive tests (100% pass rate)
✅ Cross-platform support (Windows, macOS, Linux)
✅ Production-ready with full error handling
✅ TypeScript implementation with strict typing

Made with ❤️ by Sukarth Acharya

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
src		src
tests		tests
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
jest.config.js		jest.config.js
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

License

smithery-ai/coding-agent-mcp

Folders and files

Latest commit

History

Repository files navigation

Coding Agent MCP Server

Features

🗂️ File Operations

💻 Terminal Operations

🔍 Search Operations

🛠️ Utility Operations

🛠️ Installation

Requirements

A. Using the Augment Code UI

B. Manual Configuration

Using Coding Agent with Copilot Coding Agent

Available Tools

File Operations (10 tools)

Terminal Operations (5 tools)

Search Operations (4 tools)

Utility Operations (8 tools)

File Editing Methods

1. String Replace

2. Line Numbers

3. Character Matching

4. Diff-based

Performance & Limits

Development

Setup

Build

Test

Development Mode

📚 Development Usage Examples

🗂️ File Operations Examples

Reading and Writing Files

Advanced File Editing

Directory Operations

💻 Terminal Operations Examples

Command Execution

Environment and System Info

🔍 Search Operations Examples

Text Search

File Search

Find and Replace

Duplicate Detection

🛠️ Utility Operations Examples

Time and Delays

System Information

Text Processing

JSON and Regex

File Statistics

🔄 Workflow Examples

Project Setup Automation

Code Refactoring

Contributing

License

Changelog

v1.0.0 - Latest

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages