Mamba MCP¶

A Python monorepo of MCP (Model Context Protocol) tools — a testing client and production MCP servers.

What is Mamba MCP?¶

Mamba MCP is a collection of 6 Python packages organized as a UV workspace monorepo. It provides:

4 MCP servers that expose databases, filesystems, and APIs as tools for AI assistants
1 testing client with a TUI, CLI, and Python API for debugging any MCP server
1 shared library of utilities consumed by all servers

Together, the servers expose 49 MCP tools that enable AI assistants to explore database schemas, read files, query data, manage GitLab resources, and more — all through the standardized Model Context Protocol.

Packages¶

Core & Client¶

Package	Description
mamba-mcp-core	Shared utilities: CLI helpers, error models, fuzzy matching, transport normalization
mamba-mcp-client	Testing and debugging tool for any MCP server (TUI, CLI, Python API)

MCP Servers¶

Package	Tools	Description
mamba-mcp-pg	8	PostgreSQL server with layered schema discovery and read-only query execution
mamba-mcp-fs	12	Filesystem server with local and S3 backend support
mamba-mcp-hana	11	SAP HANA server with layered schema discovery and HANA-specific tools
mamba-mcp-gitlab	18	GitLab server for merge requests, issues, pipelines, and search

Architecture at a Glance¶

graph LR
    subgraph Shared
        CORE[mamba-mcp-core]
    end

    subgraph Servers
        PG[mamba-mcp-pg<br/>8 tools]
        FS[mamba-mcp-fs<br/>12 tools]
        HANA[mamba-mcp-hana<br/>11 tools]
        GL[mamba-mcp-gitlab<br/>18 tools]
    end

    subgraph Client
        CLI[mamba-mcp-client]
    end

    PG --> CORE
    FS --> CORE
    HANA --> CORE
    GL --> CORE

Servers depend on core for shared CLI helpers, error models, and fuzzy matching
Client is independent — it communicates via MCP protocol and can test any MCP server
No cross-server dependencies — each server is independently installable

Learn more in the Architecture guide.

Quick Links¶

Getting Started — Install, configure, and run your first server
Architecture — System design, shared patterns, and dependency graph
Development Guide — Contributing, testing, and creating new server packages

Technology Stack¶

Role	Technology
Language	Python 3.11+
MCP Framework	FastMCP (`mcp >= 1.0.0`)
Validation	Pydantic + pydantic-settings
CLI Framework	Typer
TUI Framework	Textual
Package Manager	UV (workspace monorepo)
Linting	Ruff (line length: 100)
Type Checking	MyPy (strict mode)
Testing	pytest + pytest-asyncio (auto mode)

License¶

MIT