Context Engine MCP Server

# Context Engine MCP Server

A production-ready TypeScript MCP server providing comprehensive project analysis, intelligent search, multi-file editing, and dependency mapping capabilities.

## ✅ Fully Tested & Verified

## Features

- 🔍 **Comprehensive Project Analysis** - Deep analysis of project structure, dependencies, and codebase
- 🔎 **Intelligent Search** - Advanced search with regex support and structural awareness
- 📝 **Multi-file Editing** - Atomic operations across multiple files with automatic backups
- 🔗 **Dependency Mapping** - Complete file relationship and import/export analysis
- 📊 **Project Statistics** - Detailed metrics and code health insights
- ⚡ **High Performance** - Intelligent caching and optimized processing
- 🛠️ **Production Ready** - Comprehensive error handling and logging

## Quick Start

### 🚀 Using npx (Recommended & Tested)

**No installation required!** Just add this configuration to your MCP client:

```json
{
  "mcpServers": {
    "context-engine": {
      "command": "npx",
      "args": ["-y", "context-engine-mcp"]
    }
  }
}
```

### Alternative: Global Installation

1. **Install globally:**

   ```bash
   npm install -g context-engine-mcp
   ```

2. **Configure your MCP client:**

   ```json
   {
     "mcpServers": {
       "context-engine": {
         "command": "context-engine-mcp"
       }
     }
   }
   ```

### Local Development

1. **Clone and build:**

   ```bash
   git clone https://github.com/RaheesAhmed/Context-Engine-MCP-Server.git
   cd Context-Engine-MCP-Server
   npm install
   npm run build
   ```

2. **Configure with local path:**
   ```json
   {
     "mcpServers": {
       "context-engine": {
         "command": "node",
         "args": ["./dist/index.js"]
       }
     }
   }
   ```

## MCP Client Integration

### Cline (VSCode Extension)

Add to: `C:\Users\{USERNAME}\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`

### Claude Desktop

Add to: `%APPDATA%\Claude\claude_desktop_config.json`

### Other MCP Clients

Use the same configuration format shown above.

## Available Tools

| Tool                     | Description                                  |
| ------------------------ | -------------------------------------------- |
| `analyze_project`        | Comprehensive project analysis with caching  |
| `search_project`         | Intelligent search across project files      |
| `edit_multiple_files`    | Atomic multi-file editing with backups       |
| `get_file_relationships` | File dependency and import/export mapping    |
| `get_project_stats`      | Detailed project metrics and health insights |
| `clear_cache`            | Clear all cached project data                |

## Available Resources

| Resource           | URI                            | Description                        |
| ------------------ | ------------------------------ | ---------------------------------- |
| Project Analysis   | `context://project-analysis`  

... [View full README on GitHub]