AgentDesk

A multi-agent MCP server with a web UI for registering, managing, and interacting with intelligent agents.

Prerequisites

• Docker & Docker Compose installed on your machine
• (Optional) A free Groq Cloud API key for natural-language agent interactions

Quick Start

1. Clone the repository

   git clone https://github.com/uzair110/agentdesk.git
   cd agentdesk
   

2. • Configure your Groq Cloud credentials in a .env.local file in frontend/:

 NEXT_PUBLIC_API_URL=http://localhost:4000

3. • Configure your credentials in a .env file in backend/:

 NEXT_PUBLIC_GROQ_API_KEY= <YOUR_API_KEY>
 NEXT_PUBLIC_GROQ_MODEL=llama-3.3-70b-versatile
 NEXT_PUBLIC_GITHUB_TOKEN=<GITHUB_TOKEN>

4. Build & run with Docker Compose

   docker compose up --build
   

   • Frontend UI will be available at http://localhost:3000
   • Backend (MCP server) health-check at http://localhost:4000/health

5. Stopping the services

   docker compose down
   

• Register new agents via the /agents REST endpoints.

---