# agent-services-mcp

MCP Server for Git operations, agent templates, and project utilities.

## Features

### Git Operations (Token Savings: 85-95%)

| Tool | Description | Token Savings |
|------|-------------|---------------|
| `git_new_repo` | Create new GitHub repo with backup | ~950 tokens |
| `git_import_repo` | Clone and configure backup remote | ~470 tokens |
| `git_new_branch` | Create and push branch to all remotes | ~280 tokens |
| `git_archive_repo` | Archive with final backup push | ~375 tokens |
| `git_sync_backup` | Sync to backup remotes | ~280 tokens |

### Templates

| Tool | Description |
|------|-------------|
| `templates_list` | List available agent instruction templates |
| `templates_get` | Get template content by name |

### Utilities

| Tool | Description |
|------|-------------|
| `project_structure` | Get project directory structure |
| `search_files` | Search for files by pattern |

## Installation

```bash
cd agent-services-mcp
bun install
```

## Usage

### As MCP Server

```bash
bun run start
```

### Configuration

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "agent-services-mcp": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "C:\\Users\\rache\\DevProject\\agent-services-mcp",
      "env": {
        "DEVPROJECT_ROOT": "C:\\Users\\rache\\DevProject"
      }
    }
  }
}
```

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `DEVPROJECT_ROOT` | Project root directory | `~/DevProject` |
| `AGENT_TEMPLATES_DIR` | Custom templates directory | Auto-detected |

## Prerequisites

- Bun 1.0+
- Git
- GitHub CLI (`gh`) - authenticated

## License

BSD-2-Clause