Manage MCP servers across agentic IDEs
Project description
mcp-manager
Discover, monitor, and manage MCP servers across agentic IDEs.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b146b550b991c5641cd99479707ede385fdd64d16eb0d8471f2141fe9bb4317
|
|
| MD5 |
25daaa6ee70ff02910873a0c921c974c
|
|
| BLAKE2b-256 |
7bdd771f23d3810c1747a63d29b9b7d8b2166aa76b6b71161cd388ff4fe8cae1
|
Provenance
The following attestation bundles were made for arete_mcp-0.2.0.tar.gz:
Publisher:
release.yml on AreteDriver/mcp-manager
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
arete_mcp-0.2.0.tar.gz -
Subject digest:
9b146b550b991c5641cd99479707ede385fdd64d16eb0d8471f2141fe9bb4317 - Sigstore transparency entry: 1061553957
- Sigstore integration time:
-
Permalink:
AreteDriver/mcp-manager@e2d4f26aaff811221a001636173364be1124452b -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/AreteDriver
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e2d4f26aaff811221a001636173364be1124452b -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20b37cd12fa02d08ffa26d7790fbfa2e586ec2d6b8ae98e8ac29da2cee686f6c
|
|
| MD5 |
532878f2e5c6afe7df2e45784be3c901
|
|
| BLAKE2b-256 |
412be48ebedbf5551fd7ff7e8dec0c42601fb99edcb26d9212faa4e83cadbc7b
|
Provenance
The following attestation bundles were made for arete_mcp-0.2.0-py3-none-any.whl:
Publisher:
release.yml on AreteDriver/mcp-manager
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
arete_mcp-0.2.0-py3-none-any.whl -
Subject digest:
20b37cd12fa02d08ffa26d7790fbfa2e586ec2d6b8ae98e8ac29da2cee686f6c - Sigstore transparency entry: 1061553959
- Sigstore integration time:
-
Permalink:
AreteDriver/mcp-manager@e2d4f26aaff811221a001636173364be1124452b -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/AreteDriver
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e2d4f26aaff811221a001636173364be1124452b -
Trigger Event:
push
-
Statement type: