# rinadelph/Agent-MCP [Health: Active]

**Category:** 🤖 Coding Agents  
**Repository:** https://github.com/rinadelph/Agent-MCP  
**GitHub Stars:** 1291  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/rinadelph-agent-mcp

## Description
A framework for creating multi-agent systems using MCP for coordinated AI collaboration, featuring task management, shared context, and RAG capabilities.

## Tools
Capabilities this server exposes over MCP:

- **create_agent**
- **list_agents**
- **terminate_agent**
- **assign_task**
- **view_tasks**
- **update_task_status**
- **ask_project_rag**
- **update_project_context**
- **view_project_context**
- **send_agent_message**
- **broadcast_message**
- **request_assistance**

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "agent-mcp": {
    "url": "http://localhost:8000/mcp"
  }
}
```

## Documentation

## What rinadelph/Agent-MCP does

The rinadelph/Agent-MCP MCP server coordinates multiple AI agents around a software project. It provides separate tool groups for agent lifecycle management, task orchestration, shared project knowledge, and communication. An MCP client can create specialized agents, assign work, inspect progress, and shut agents down when they are no longer needed.

Project information is stored in a persistent knowledge graph or memory bank. Agents can add architectural decisions and implementation details, inspect stored context, and submit retrieval-augmented questions about the project. This is intended to reduce repeated explanations across sessions and help agents work from common project information.

## How it works

The rinadelph/Agent-MCP MCP server can run using the repository's Python implementation or an alternative Node.js/TypeScript implementation. The Python server is started with the `agent_mcp.cli` module; the Node.js version can be started with the repository's npm scripts or its documented global command. The README describes HTTP and WebSocket MCP endpoints, including `/mcp` and `/mcp/ws` examples.

A connected client calls tools rather than managing agents through a separate application protocol. Typical operations include creating a backend or frontend agent, assigning it a task, checking task dependencies and status, then using direct or broadcast messages to coordinate work. The project also includes a dashboard that can be launched separately for visualizing agents, context entries, and collaboration links.

## Setup and configuration

The documented Python setup requires Python 3.10 or newer, Node.js 18 or newer, and npm 9 or newer. After cloning the repository, the README instructs users to create a virtual environment, install dependencies with `uv`, copy `.env.example` to `.env`, and provide an OpenAI API key. The Python server can then be started with `uv run -m agent_mcp.cli --port 8080`.

The Node.js alternative is located under `agent-mcp-node`. It uses `npm install`, environment configuration, and either `npm run server` or the built `npm start` command. The dashboard has its own npm dependency installation and development command.

Configuration supports host, port, log level, project directory, and maximum agent count through `AGENT_MCP_HOST`, `AGENT_MCP_PORT`, `AGENT_MCP_LOG_LEVEL`, `AGENT_MCP_PROJECT_DIR`, and `AGENT_MCP_MAX_AGENTS`. The CLI also documents an optional authentication token. The README shows Claude Desktop configuration using the `uv` command and an `OPENAI_API_KEY` environment value.

## Tools and capabilities

The rinadelph/Agent-MCP MCP server exposes these documented tools:

- Create, list, and terminate agents.
- Assign tasks, inspect tasks, and update task status.
- Query project knowledge with `ask_project_rag`.
- Read and update shared project context.
- Send direct messages, broadcast updates, and request assistance.

The README describes Claude Desktop and Cline as compatible MCP clients. It also includes a Python client example that creates an agent, assigns a task, and queries project context.

## Limitations and notes

The project is aimed at experienced AI developers who understand MCP, AI coding workflows, and distributed systems concepts. Its documentation notes that the setup and orchestration model may be unsuitable for users seeking a simpler coding assistant. The material does not specify a license or a hosted service, so deployment, maintenance, and OpenAI API costs remain the operator's responsibility.

## Getting started with this rinadelph/Agent-MCP MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/rinadelph-agent-mcp/readme_