# Full-Stack MCP Server

**MCP server for full-stack development with OpenCode CLI integration.**

A Model Context Protocol (MCP) server that provides specialized AI agents for full-stack web development, powered by high-speed inference from Cerebras.

## Features

- **8 Specialized Managers**: Frontend, Backend, Database, API, DevOps, Testing, Security, Performance
- **High-Speed Inference**: 2000-3000 tokens/sec via Cerebras API
- **Structured Workflow**: Explore → Plan → Execute → Verify
- **Claude Integration**: Works seamlessly with Claude Code

## Prerequisites

- Node.js 18+
- OpenCode CLI (`npm install -g opencode`)
- Cerebras API key

## Installation

```bash
# Clone the repository
git clone <repository-url>
cd cerebras-code-fullstack-mcp

# Run the installation script
./install.sh
```

## Configuration

### Add to Claude Code

```bash
claude mcp add fullstack-mcp \
  --command node \
  --args "/path/to/dist/index.js" \
  --args "-m" \
  --args "cerebras/zai-glm-4.6" \
  --env CEREBRAS_API_KEY=your-api-key
```

### Or add to `.mcp.json`

```json
{
  "mcpServers": {
    "fullstack-mcp": {
      "command": "node",
      "args": ["/path/to/dist/index.js", "-m", "cerebras/zai-glm-4.6"],
      "env": {
        "CEREBRAS_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Project Setup

Initialize a new project with full-stack agents:

```bash
./init-project.sh /path/to/your/project
```

This creates:
- `opencode.json` - Configuration with auto-approved permissions
- `.opencode/agent/` - Specialized agent files for each manager

## Available Managers

| Manager | Use For |
|---------|---------|
| `frontend-manager` | React, Vue, Svelte, CSS, accessibility |
| `backend-manager` | Node.js, Express, FastAPI, Django |
| `database-manager` | PostgreSQL, MongoDB, Redis, migrations |
| `api-manager` | REST, GraphQL, WebSocket, auth |
| `devops-manager` | Docker, CI/CD, deployment |
| `testing-manager` | Unit, integration, E2E tests |
| `security-manager` | Auth, OWASP, validation |
| `performance-manager` | Caching, optimization, profiling |

## Usage with Claude

```typescript
// Example: Create a React component
mcp__fullstack-mcp__frontend-manager(
  prompt="TASK: Create a Button component with primary and secondary variants",
  cwd="/path/to/project"
)

// Example: Add an API endpoint
mcp__fullstack-mcp__api-manager(
  prompt="TASK: Add a POST /api/users endpoint with validation",
  cwd="/path/to/project"
)
```

## Project Structure

```
cerebras-code-fullstack-mcp/
├── .opencode/
│   └── agent/           # Specialist agent prompts
├── fullstack-guides/    # Reference documentation
├── src/
│   ├── index.ts         # MCP server entry point
│   ├── constants.ts     # Configuration
│   ├── tools/           # Tool implementations
│   └── utils/           # Utilities
├── CLAUDE.md            # Claude orchestration guide
├── WORKING_INSTRUCTIONS.md
├── package.json
└── tsconfig.json
```

## Development

```bash
# Build
npm run build

# Run in development
npm run dev

# Type check
npm run lint
```

## The Orchestration Pattern

This MCP server follows a specific workflow:

1. **Claude** receives user request
2. **Claude** breaks it into focused steps
3. **Claude** calls appropriate manager MCP tool
4. **OpenCode** executes with specialized agent
5. **Claude** verifies the result
6. Repeat until complete

See `CLAUDE.md` for detailed orchestration instructions.

## License

MIT