jaegis-mcp-server/README.md

JAEGIS MCP Server for Cline

# JAEGIS MCP Server

A Model Context Protocol (MCP) server for Cline, providing JAEGIS system integration.

## Features

- **Persistent JAEGIS System Activation**: Ensures the JAEGIS system remains active at all times.
- **Universal Input Processing**: Processes any natural text input through the JAEGIS system.
- **System Status Monitoring**: Provides comprehensive status and metrics for the JAEGIS system.
- **Workspace Analysis**: Analyzes the workspace using the active JAEGIS system.

## Installation

You can install the package globally using npm:

```bash
npm install -g jaegis-mcp-server
```

## Usage

### With Cline

Add the following configuration to your Cline MCP settings:

```json
{
  "mcpServers": {
    "jaegis": {
      "disabled": false,
      "timeout": 120,
      "type": "stdio",
      "command": "npx",
      "args": [
        "jaegis-mcp-server"
      ]
    }
  }
}
```

### Manual Usage

You can also run the server manually:

```bash
npx jaegis-mcp-server
```

## Tools

The server provides the following tools:

### `ensure_jaegis_active`

Ensures the JAEGIS system is active and processes any input.

**Parameters:**
- `user_input` (string): ANY natural text input.

### `process_any_input`

Processes any natural text input through the persistent JAEGIS system.

**Parameters:**
- `input_text` (string): ANY natural text input.

### `get_jaegis_status`

Gets comprehensive JAEGIS system status and metrics.

**Parameters:**
- `detailed` (boolean, optional): Whether to return detailed status.

### `activate_jaegis_system`

Initializes or reactivates the JAEGIS system.

**Parameters:**
- `force_reinitialize` (boolean, optional): Force reinitialization even if already active.

### `workspace_analysis`

Analyzes the workspace using the active JAEGIS system.

**Parameters:**
- `analysis_type` (string, optional): Type of analysis to perform. Can be "quick", "full", or "dependencies".

## Development

### Prerequisites

- Node.js (v20 or higher)
- npm (v10 or higher)

### Setup

1. Clone the repository:
   ```bash
   git clone https://github.com/your-username/jaegis-mcp-server.git
   cd jaegis-mcp-server
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build the project:
   ```bash
   npm run build
   ```

### Running in Development Mode

```bash
npm run dev
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.