MCPgee
MCPgee
MCPgeeMCPgee

Mathom

v1.0.0•Developer Tools•stable

Run and monitor MCP servers locally

mathommcpai-integration
Share:
214
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Mathom?

Mathom is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to run and monitor mcp servers locally

Run and monitor MCP servers locally

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Run and monitor MCP servers locally

Use Cases

Run and monitor MCP servers locally.
Manage server lifecycle and health.
Simplify local MCP development workflows.
stephenlacy

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedApr 29, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mathom

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 Mathom

Mathom is a local MCP server management platform that lets developers run, monitor, and debug multiple MCP servers through a unified dashboard with live logs, performance metrics, and built-in OAuth2 support for compatible clients. It wraps MCP servers — including STDIO-based ones — inside Docker containers so they run in isolated, reproducible environments, and exposes them through a single management interface accessible from Claude Desktop, Cursor, and other MCP clients. Developers who juggle multiple MCP servers and want centralised health monitoring, real-time logging, and a clean dark/light dashboard use Mathom to manage their local MCP infrastructure.

Prerequisites

  • Docker with Docker Compose installed
  • Node.js and npm (for the mcx CLI tool)
  • Go 1.21+ if running the podrift backend from source
  • pnpm for the dashboard frontend if building from source
  • Optional: A GitHub Personal Access Token if using the GitHub MCP server
1

Start Mathom with Docker Compose

The recommended way to run Mathom is via Docker Compose, which starts both the podrift backend and the dashboard frontend together.

git clone https://github.com/stephenlacy/mathom.git
cd mathom
docker compose up -d
2

Configure environment variables

Create a .env file with the required configuration for the backend and database.

BETTER_AUTH_URL=http://localhost:5050
DATABASE_URL=postgresql://user:pass@localhost:5432/mathom
LOG_URL=http://localhost:5050/logs
3

Install the mcx CLI

Install the mcx command-line tool globally to launch and manage individual MCP servers from the terminal.

npm install -g mcx
4

Launch MCP servers with mcx

Use the mcx command to start any MCP server. Mathom will track it in the dashboard with live logs and metrics.

# Launch a standard MCP server by package name
mcx @modelcontextprotocol/server-filesystem

# Launch with custom arguments
mcx my-server -- --custom-arg value

# Launch a Docker-based MCP server with environment variables
mcx --docker mcp/github-mcp-server -e GITHUB_PERSONAL_ACCESS_TOKEN='your_token'
5

Connect Claude Desktop to Mathom

Configure Claude Desktop to use Mathom as the MCP endpoint by pointing it to the Mathom server URL.

{
  "mcpServers": {
    "mathom": {
      "command": "npx",
      "args": ["mathom"],
      "env": {
        "MATHOM_URL": "http://localhost:5050"
      }
    }
  }
}
6

Access the dashboard

Open the Mathom dashboard in your browser to view running servers, live logs, and performance metrics. The dashboard supports dark and light themes.

open http://localhost:5050

Mathom Examples

Client configuration

claude_desktop_config.json entry for connecting to a local Mathom instance.

{
  "mcpServers": {
    "mathom": {
      "command": "npx",
      "args": ["mathom"],
      "env": {
        "MATHOM_URL": "http://localhost:5050"
      }
    }
  }
}

Prompts to try

Example prompts for managing and monitoring MCP servers through the Mathom dashboard.

- "List all MCP servers currently running in Mathom."
- "Show me the recent error logs for the filesystem MCP server."
- "What is the current CPU and memory usage of the GitHub MCP server?"
- "Start the Puppeteer MCP server and show me its startup logs."
- "Which MCP servers have had errors in the last hour?"

Troubleshooting Mathom

Docker Compose fails to start Mathom services

Ensure Docker Desktop is running and that port 5050 is free. Check that DATABASE_URL in .env points to a reachable PostgreSQL instance. Run 'docker compose logs' to see specific startup errors.

mcx command not found after npm install

Ensure the npm global bin directory is on your PATH. Run 'npm bin -g' to find it and add it to your shell's PATH. On macOS with Homebrew Node, this is usually /usr/local/bin or /opt/homebrew/bin.

MCP servers launched with mcx are not appearing in the Mathom dashboard

Make sure MATHOM_URL is set to the correct URL (http://localhost:5050 by default) in your environment before running mcx. The CLI uses this URL to register servers with the Mathom backend.

Frequently Asked Questions about Mathom

What is Mathom?

Mathom is a Model Context Protocol (MCP) server that run and monitor mcp servers locally It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mathom?

Follow the installation instructions on the Mathom GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Mathom?

Mathom works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mathom free to use?

Yes, Mathom is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Mathom Alternatives — Similar Developer Tools Servers

Looking for alternatives to Mathom? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

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

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

Read the full setup guide →

Ready to use Mathom?

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
Explore All ServersRead Our Guides