Mangaba AI

v1.0.0Coding Agentsstable

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).

mangaba-aimcpai-integration
Share:
197
Stars
0
Downloads
0
Weekly
0/5

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

Create intelligent AI agents with Agent-to-Agent protocols.
Build modular AI systems using MCP standards.
Mangaba-ai

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mangaba-ai

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

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
1

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]
2

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-key
3

Create 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)
4

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"
    )
)
5

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 context

Mangaba 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.

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.

Quick Config Preview

{ "mcpServers": { "mangaba-ai": { "command": "npx", "args": ["-y", "mangaba-ai"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides