# 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