Installing Maeris MCP

Maeris MCP is a Python-based CLI and Model Context Protocol server that integrates directly with AI-powered editors like Claude Code and Cursor. This guide walks you through installing the package, verifying your setup, and preparing to initialize your first project.

Prerequisites

Before installing Maeris MCP, make sure your system meets the following requirements:

Python 3.10 or higher is required.

Maeris MCP uses modern Python typing features and async capabilities introduced in Python 3.10. Earlier versions are not supported.

To check your current Python version, run:

python3 --version

You should see output like Python 3.10.x or higher. If your version is older, visit python.org/downloads to upgrade.

Installing via pip

Install the Maeris MCP package using pip. It is recommended to install it globally so the maeris command is available system-wide.

pip install maeris

If you use pip3 as your default Python 3 package manager:

pip3 install maeris

To install or upgrade to the latest version:

pip install --upgrade maeris

Verifying Your Installation

After installation, verify that the CLI is available on your PATH by running the version command:

maeris --version

You should see output similar to:

maeris version 1.x.x

Command not found?

If you see a "command not found" error, the pip bin directory may not be on your PATH. Run python3 -m maeris --version as an alternative, or add your Python scripts directory to your shell's PATH configuration.

Compatibility with AI Editors

Maeris MCP is designed to work as a Model Context Protocol server, which means it integrates directly into AI-powered coding environments. Supported editors include:

Claude Code — Anthropic's official CLI editor (recommended)
Cursor — AI-first code editor with MCP support
Any editor that supports the MCP stdio protocol

Once installed, Maeris exposes its tools to your AI editor through a .mcp.json configuration file that you create in your project root. The server runs via maeris serve in stdio mode, and your editor communicates with it automatically.

Running the Diagnostics Check

After installation, you can run the built-in doctor command to verify your environment is fully configured:

maeris doctor

This checks your Python version, pip installation, PATH configuration, and network reachability of the Maeris servers. See the Diagnosing Setup Issues guide for details on interpreting the output.

Next Steps

Now that Maeris MCP is installed, the next step is to initialize it in your project. Head over to the Initialize Your Project guide to set up your .mcp.json and connect your repository.