Mamba MCP

曼巴MCP

MCP（模型上下文协议）工具的Python集合——测试客户端和生产MCP服务器，作为一个单独的包分发，并带有可选的附加功能。

安装

# Core only
pip install mamba-mcp

# With specific servers
pip install mamba-mcp[pg]       # PostgreSQL server
pip install mamba-mcp[fs]       # Filesystem server (local + S3)
pip install mamba-mcp[hana]     # SAP HANA server
pip install mamba-mcp[gitlab]   # GitLab server

# Client (TUI, CLI, Python API)
pip install mamba-mcp[client]

# Everything
pip install mamba-mcp[all]

模块

曼巴mcp客户端

MCP服务器的测试和调试工具。支持基于stdio、SSE、HTTP和UV的传输。

曼巴MCP客户端TUI

Mamba MCP Client

• 交互式TUI --基于文本的终端接口，用于实时探索服务器
• CLI命令 --用于检查和脚本编写的快速一次性命令
• Python API --用于测试自动化的完全异步编程接口
• 协议日志记录 --详细的请求/响应捕获和计时

# Launch interactive TUI
mamba-mcp tui --stdio "python server.py"

# CLI inspection
mamba-mcp tools --stdio "python server.py"
mamba-mcp call add --args '{"a": 5, "b": 3}' --stdio "python server.py"

曼巴mcp pg

PostgreSQL MCP服务器，具有用于AI助手的3层工具架构。

• 第1层：模式发现 --列出模式、表、描述列、示例行
• 第二层：关系发现 --外键、连接路径查找（BFS）
• 第3层：查询执行 --具有参数化查询和EXPLAIN支持的只读SQL

# Test database connection
mamba-mcp-pg --env-file mamba.env test

# Run the MCP server
mamba-mcp-pg --env-file mamba.env

曼巴mcp fs

文件系统MCP服务器，带有用于AI助手的本地和S3后端。

• 第1层：发现 --列出目录、读取文件、获取元数据、按名称/内容搜索
• 第二层：S3附加 --列出存储桶、预签名URL、对象元数据（启用S3时）
• 第三层：突变 --写入、删除、移动、复制文件、创建目录（读写时）

# Test configuration and backend connectivity
mamba-mcp-fs --env-file mamba.env test

# Run the MCP server
mamba-mcp-fs --env-file mamba.env

曼巴·麦克普·哈纳

SAP HANA MCP服务器，具有用于AI助手的4层工具架构。

• 第1层：模式发现 --列出模式、表、描述列、示例行
• 第二层：关系发现 --外键、连接路径查找（BFS）
• 第3层：查询执行 --具有参数化查询和EXPLAIN支持的只读SQL
• HANA专用工具 --计算视图、列/行存储类型、存储过程

# Test database connection
mamba-mcp-hana --env-file mamba.env test

# Run the MCP server
mamba-mcp-hana --env-file mamba.env

曼巴mcp gitlab

GitLab MCP服务器，用于合并请求、问题、管道和搜索。

• 合并请求（7） --列表、获取、差异、提交、管道、创建、更新
• 问题（6） --列出、获取、评论、创建、更新、添加评论
• 管道（4） --列表、获取、作业、作业日志
• 搜索（1） --实例、项目或组范围的搜索

# Test GitLab connectivity
mamba-mcp-gitlab --env-file mamba.env test

# Run the MCP server
mamba-mcp-gitlab --env-file mamba.env

建筑

所有四个MCP服务器模块都遵循一致的内部架构 FastMCP 带着一个 分层工具系统:

__main__.py (Typer CLI)
  → server.py (FastMCP + lifespan resource management)
    → tools/ (MCP tool handlers, organized by layer)
      → database/ or backends/ (service layer)
        → models/ (Pydantic I/O contracts)

跨服务器的共享模式：

• 分层工具 --工具从发现到进展→ 关系→ 执行，专为人工智能代理的增量探索而设计
• AppContext通过生命周期 --资源（数据库引擎、连接池、后端）在启动时初始化，在关闭时清理
• Pydantic设置 --基于环境的配置 MAMBA_MCP_{PKG}_* 前缀和 mamba.env 文件自动发现
• 错误框架 --带有模糊名称匹配（“你是说？”）建议的结构化错误代码
• 服务层 --精简工具处理程序委托给封装域逻辑的服务类

技术栈： Python 3.11+、FastMCP、Pydantic、Typer、Textual、SQLAlchemy+asyncpg、hdbcli、fsspec+s3fs、httpx

配置

所有服务器都使用 mamba.env 用于基于环境的配置。默认文件位置（按顺序选中）：

1. ./mamba.env （项目本地）
2. ~/mamba.env （全局回退）

发展

# Install with all extras and dev tools
uv sync --all-extras --group dev

# Run tests
uv run pytest tests/                    # all tests
uv run pytest tests/pg/                 # per-module
uv run pytest tests/core/ tests/client/ # multiple modules

# Type check
uv run mypy src/

# Lint and format
uv run ruff check src/
uv run ruff format src/

仓库结构

mamba-mcp/
├── pyproject.toml              # Single package config with extras
├── uv.lock                     # Shared lockfile
├── src/
│   ├── mamba_mcp_core/         # Shared utilities
│   ├── mamba_mcp_client/       # MCP testing client
│   ├── mamba_mcp_pg/           # PostgreSQL MCP server
│   ├── mamba_mcp_fs/           # Filesystem MCP server
│   ├── mamba_mcp_hana/         # SAP HANA MCP server
│   └── mamba_mcp_gitlab/       # GitLab MCP server
├── tests/
│   ├── core/
│   ├── client/
│   ├── pg/
│   ├── fs/
│   ├── hana/
│   └── gitlab/
├── examples/                   # Client usage examples
├── docs/                       # MkDocs documentation
└── internal/                   # Specs & images

许可证

麻省理工学院