Mangaba AI
Repositório minimalista para criação de agentes de IA inteligentes e versáteis com protocolos A2A (Agent-to-Agent) e MCP (Model Context Protocol).
What is Mangaba AI?
Mangaba AI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to repositório minimalista para criação de agentes de ia inteligentes e versáteis com protocolos a2a (agent-to-agent) e mcp (model context protocol).
Repositório minimalista para criação de agentes de IA inteligentes e versáteis com protocolos A2A (Agent-to-Agent) e MCP (Model Context Protocol).
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Repositório minimalista para criação de agentes de IA inteli
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mangaba-aiConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mangaba AI
Mangaba AI is a professional multi-agent orchestration framework for Python that supports both A2A (Agent-to-Agent) and MCP (Model Context Protocol) communication standards. It provides a lightweight but feature-rich alternative to CrewAI and LangChain in a single package, with native support for ReAct reasoning, function calling, RAG pipelines, persistent memory, and multiple LLM providers including Google Gemini, OpenAI GPT, Anthropic Claude, HuggingFace, and OpenRouter. Developers use it to build modular AI systems where agents collaborate, share context, and delegate tasks across provider boundaries.
Prerequisites
- Python 3.10 or higher
- pip package manager
- API key for at least one LLM provider (Google Gemini, OpenAI, Anthropic Claude, or OpenRouter)
- An MCP client such as Claude Desktop or Claude Code if using MCP integration
- Optional: ChromaDB, PostgreSQL+pgvector, or Redis for advanced vector store features
Install Mangaba AI via pip
Install the base package for core multi-agent and MCP functionality. Use the [all] extra to include RAG support with embeddings and additional vector store backends.
pip install mangaba
# Or with RAG and embeddings support
pip install mangaba[all]Set your LLM provider API key
Configure the API key for your chosen LLM provider. Mangaba supports Google Gemini, OpenAI, Anthropic Claude, HuggingFace, and OpenRouter. You can also mix providers within the same agent crew.
export GOOGLE_API_KEY=your-gemini-key
# or
export OPENAI_API_KEY=your-openai-key
# or
export ANTHROPIC_API_KEY=your-anthropic-keyCreate your first agent with a tool
Define an agent using the @tool decorator and LLMConfig. The agent will use ReAct reasoning to decide when to call tools and how to combine results into a final output.
from mangaba.core import Agent, Task, Crew, Process, tool
from mangaba.core.types import LLMConfig
@tool
def search(query: str) -> str:
"""Search the web for information."""
return f"Results for: {query}"
researcher = Agent(
role="Research Analyst",
goal="Find accurate information",
backstory="Expert researcher",
tools=[search],
llm_config=LLMConfig(provider="google", model="gemini-2.5-flash", api_key="YOUR_KEY"),
)
task = Task(
description="Research the latest AI trends",
expected_output="A list of top 5 trends with explanations",
agent=researcher,
)
crew = Crew(agents=[researcher], tasks=[task], process=Process.SEQUENTIAL)
result = crew.kickoff()
print(result.final_output)Build a multi-provider crew with fallback
Combine agents using different LLM providers in the same crew. OpenRouter config supports automatic fallback between multiple models if the primary is unavailable.
from mangaba.core.types import OpenRouterConfig
agent = Agent(
role="Analyst",
goal="Analyze data",
llm_config=OpenRouterConfig(
provider="openrouter",
model=["google/gemini-2.5-flash", "anthropic/claude-3.5-sonnet"],
api_key="YOUR_OPENROUTER_KEY"
)
)Enable MCP protocol for agent communication
Mangaba supports MCP for hierarchical context sharing between agents. Import the MCP module to set up a context server that multiple agents can read from and write to.
from mangaba.protocols import MCPContext
context = MCPContext()
context.set("shared_data", {"user_id": 123, "session": "abc"})
# Agents can now read this shared contextMangaba AI Examples
Client configuration (Claude Desktop)
If you are using Mangaba as an MCP server within Claude Desktop, run it as a subprocess. Install via pip first then point to the mangaba MCP entry point.
{
"mcpServers": {
"mangaba-ai": {
"command": "python",
"args": ["-m", "mangaba.mcp"],
"env": {
"GOOGLE_API_KEY": "your-gemini-api-key",
"OPENAI_API_KEY": "your-openai-api-key"
}
}
}
}Prompts to try
Use these prompts when Mangaba is integrated into your AI workflow for multi-agent task delegation.
- "Create a research agent that searches for information and a writer agent that summarizes it"
- "Set up a crew where one agent collects data and another validates it"
- "Build a sequential pipeline: data collector → analyst → report writer"
- "Create agents using both Gemini and Claude in the same crew with OpenRouter fallback"
- "Set up persistent memory so agents remember context across sessions"Troubleshooting Mangaba AI
Agent fails with LLM provider authentication error
Verify your API key is set correctly either via environment variable or LLMConfig(api_key=...). For OpenRouter, ensure you use the OpenRouterConfig class, not LLMConfig, and that your key has credits available.
RAG pipeline returns no results or embedding errors
Install the full extras: `pip install mangaba[all]`. For HuggingFace embeddings ensure sentence-transformers is installed. Check your vector store connection (ChromaDB, PostgreSQL, or Redis) is running and accessible.
Tool decorated functions are not being called by the agent
Ensure the @tool decorator is imported from `mangaba.core` and the function has a proper docstring — the docstring is used as the tool description for the LLM's function calling schema. Pass the tool in the agent's tools=[...] list.
Frequently Asked Questions about Mangaba AI
What is Mangaba AI?
Mangaba AI is a Model Context Protocol (MCP) server that repositório minimalista para criação de agentes de ia inteligentes e versáteis com protocolos a2a (agent-to-agent) e mcp (model context protocol). It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mangaba AI?
Follow the installation instructions on the Mangaba AI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mangaba AI?
Mangaba AI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mangaba AI free to use?
Yes, Mangaba AI is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Mangaba AI Alternatives — Similar Coding Agents Servers
Looking for alternatives to Mangaba AI? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mangaba AI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mangaba AI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.