-
securityF
license-
qualityEnables AI agent and task management using the CrewAI framework, allowing users to create and run agents and tasks in an automated workflow environment.
Last updated -
0
3
JavaScript
Provides containerized deployment through Docker, enabling easy setup and management of the MCP agent server environment
Supports Git for version control and project management, allowing users to clone and manage the repository
Enables repository hosting and management through GitHub, providing access to the MCP server codebase
Integrates with n8n workflow engine to execute automated tasks and workflows, allowing AI agents to trigger actions and orchestrate processes via natural language instructions
Built on Node.js runtime, allowing execution of JavaScript-based agent logic and API endpoints
Uses Prisma for database migrations and schema management, supporting the agent memory and persistence features
# MCP Agent Server
This is the open-source "brain" for AI employees, designed to work with n8n and other workflow engines.
Quick Start
- Clone the repo: git clone https://github.com/yourusername/mcp-agent-server.git cd mcp-agent-server
- Copy over your docs and memory folders if needed.
- Build and run with Docker Compose: docker-compose up --build
- The MCP server will be available at http://localhost:4000
Getting Started
- Ensure you have Node.js and Docker installed.
- Remove any comments from package.json (JSON does not support comments).
- Run
npm installto install dependencies. - Use
docker-compose up --buildto start all services. - The server will be available at http://localhost:4000.
- For architecture and design, see the /docs and /memory folders and the "mcp-agent-server project plan" in MCP memory.
Project Structure
- /docs — Design, architecture, and usage documentation
- /memory — Persistent memory, logs, and knowledge
Project Vision: MCP Agent Server
The mcp-agent-server is an open-source, modular "brain" for AI employees/agents, designed to work seamlessly with n8n and other workflow engines.
- AI Employee Metaphor:
Enables users to "hire," "assign," "grade," and "improve" persistent AI agents, each with their own memory, learning, and feedback loop. - Opinionated & Agent-Centric:
Unlike generic workflow automation tools, the MCP agent server is opinionated and focused on the "AI employee" metaphor, making memory, feedback, and learning core features—not optional add-ons. - Natural Language Interface:
Accepts natural language instructions (not just API calls or workflow triggers), parses them into actionable tasks, and orchestrates execution via n8n or other connectors. - Proactive, Adaptive, and Personalized:
Agents can suggest actions, learn from user feedback, and improve over time. - Vertical Solutions & Simplicity:
Supports vertical solutions (e.g., "AI Analyst," "AI Admin") with prebuilt skills, workflows, and feedback loops, as well as a simple, non-technical user experience for SMBs and individuals. - Persistent, Agent-Centric Memory:
Memory and feedback are persistent and agent-centric, enabling agents to remember past actions, user preferences, and performance history. - Easy Deployment & Extensibility:
Designed for easy deployment (Docker, Docker Compose), extensibility (pluggable connectors and skills), and SaaS monetization (multi-tenant, API key management, billing integration). - Not Just Another Workflow Tool:
The MCP agent server is a platform for building, managing, and improving AI employees that work alongside humans, learn from experience, and deliver real business value.
For full design, architecture, and context, see the "mcp-agent-server project plan" entity in MCP memory and the /docs and /memory folders.
API Authentication
All endpoints (except /health, /users/register, and /users/login) require an x-api-key header. API keys are managed per user. See below for user and API key management.
User & API Key Management
Endpoints
POST /users/register— Register a new user (email, password)POST /users/login— Login and receive an API keyGET /users/me/api-keys— List your API keysPOST /users/me/api-keys— Create a new API keyDELETE /users/me/api-keys/:id— Revoke an API key
Example PowerShell Usage
Example curl Usage
Agent Memory & Feedback Endpoints
POST /agents/:id/memory— Add memory/feedback for an agent.GET /agents/:id/memory— List all memory/feedback for an agent.POST /agents/:id/trigger— Trigger an agent action (stub for n8n integration).
Example PowerShell Usage
Example curl Usage
Database Migrations & Schema Management
- All database migrations are applied automatically on container startup (see
docker-entrypoint.sh). - To add new models or fields:
- Edit
prisma/schema.prisma. - Run
npx prisma migrate dev --name <desc>locally (with your Docker Postgres running). - Commit the generated migration files in
prisma/migrations/to git.
- Edit
- On every deploy or container rebuild, all migrations will be applied automatically.
This server cannot be installed
An open-source "brain" for AI employees that enables users to create, manage, and improve persistent AI agents with their own memory and learning capabilities.
Related MCP Servers
- AsecurityAlicenseAqualityA flexible memory system for AI applications that supports multiple LLM providers and can be used either as an MCP server or as a direct library integration, enabling autonomous memory management without explicit commands.Last updated -321151JavaScriptMIT License
- -securityFlicense-qualityIntegrates with the AgentCraft framework to enable secure communication and data exchange between AI agents, supporting both premade and custom enterprise AI agents.Last updated -Python
- -securityFlicense-qualityA modern AI service proxy that enables interaction with multiple AI providers (Anthropic Claude, OpenAI) through a unified API, deployed globally using Cloudflare Workers.Last updated -17TypeScript