Skip to main content

Manage MCP servers across agentic IDEs

Project description

mcp-manager

Discover, monitor, and manage MCP servers across agentic IDEs.

CI CodeQL Python License: MIT


The Problem

MCP servers are configured per-IDE in different JSON files with different schemas. If you use Claude Code, Cursor, and Windsurf, your servers are scattered across three configs with no unified view.

mcp-manager gives you one CLI to see, health-check, and manage all of them.


Install

pip install mcp-manager

Usage

# List all MCP servers across all IDEs
mcp-manager list

# Filter by IDE
mcp-manager list --tool cursor

# Health check all servers
mcp-manager health

# Show server-to-IDE mapping
mcp-manager map

# Export/import configs (portable YAML/JSON)
mcp-manager export servers.yaml
mcp-manager import servers.yaml

# Add/remove servers from the registry
mcp-manager add my-server --command "node server.js"
mcp-manager remove my-server

Supported IDEs

IDE Config Path
Claude Code ~/.claude.json
Claude Desktop ~/.config/Claude/claude_desktop_config.json
Cursor ~/.cursor/mcp.json
Windsurf ~/.windsurf/mcp_config.json
Project-level .mcp.json (walks parent dirs)

Transport Types

  • stdio — local subprocess, JSON-RPC over stdin/stdout
  • sse — Server-Sent Events over HTTP
  • http — HTTP POST JSON-RPC

Status

  • Read-only config discovery across 5 IDE configs
  • Async health checks with timeout
  • JSON registry with add/remove
  • YAML/JSON export/import
  • Protocol handshake testing
  • Config write-back (edit IDE configs directly)
  • Server auto-restart on failure

Part of the AreteDriver AI tooling ecosystem.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arete_mcp-0.2.0.tar.gz (30.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

arete_mcp-0.2.0-py3-none-any.whl (23.8 kB view details)

Uploaded Python 3

File details

Details for the file arete_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: arete_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 30.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for arete_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 9b146b550b991c5641cd99479707ede385fdd64d16eb0d8471f2141fe9bb4317
MD5 25daaa6ee70ff02910873a0c921c974c
BLAKE2b-256 7bdd771f23d3810c1747a63d29b9b7d8b2166aa76b6b71161cd388ff4fe8cae1

See more details on using hashes here.

Provenance

The following attestation bundles were made for arete_mcp-0.2.0.tar.gz:

Publisher: release.yml on AreteDriver/mcp-manager

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file arete_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: arete_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 23.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for arete_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 20b37cd12fa02d08ffa26d7790fbfa2e586ec2d6b8ae98e8ac29da2cee686f6c
MD5 532878f2e5c6afe7df2e45784be3c901
BLAKE2b-256 412be48ebedbf5551fd7ff7e8dec0c42601fb99edcb26d9212faa4e83cadbc7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for arete_mcp-0.2.0-py3-none-any.whl:

Publisher: release.yml on AreteDriver/mcp-manager

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page