list_serversLABSCO SUMMARY
Give it the config file it is not itself listed in.
Two instances with different MCP_CONFIG_PATH values is the practical setup: one editing the AWS Q Developer file, one editing Claude Desktop's. Backups plus atomic writes mean a malformed edit costs you a restore rather than a broken client, and validate_config will tell you which it was before you restart anything.
What it is
A configuration editor for MCP config files — the JSON that lists which servers a client loads. It reads, edits and validates that file for AWS Q Developer or Claude Desktop, and backs it up before every change.
What you get
list_serversshows every server currently configured, andget_serverreturns one entry by nameadd_serveradds an entry with its command, args and env;update_serveredits one, merging environment variables by default or replacing them when you passreplace_envremove_serverdeletes an entryvalidate_configchecks the file's structure and contents, andexport_configdumps the whole configuration as JSON- Every change is written atomically and preceded by a timestamped backup
Requirements
The Python package mcp-conf-mcp-server, version 0.1.0, run with uvx --from git+https://github.com/r3-yamauchi/mcp-conf-mcp-server.git mcp-conf-mcp-server, or installed with pip install -e .. It edits ~/.aws/amazonq/mcp.json unless you point MCP_CONFIG_PATH somewhere else — set it to the Claude Desktop config path to manage that instead. MCP_BACKUP_DIR moves the backups; by default they land in a backups/ folder beside the config. ~, %APPDATA% and %USERPROFILE% are expanded for you.
Setup effort
Add the configuration to your client
USE CASES
Adding a new server without hand-editing JSON
Describe the command, args and environment in the chat and have the entry written correctly.
Rotating a key held in a server's env block
Update just that variable — the merge behaviour leaves the rest of the environment alone.
Auditing what a client is loading
List every configured server, then read one back in full to see how it launches.
Taking a backup before a risky change
Export the whole configuration as JSON and keep it aside.
7 tools
Listed in project docs. Your client may show a different list.
get_serveradd_serverupdate_serverremove_servervalidate_configexport_configBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
MCP Clients
Amazon Q Developer
{
"mcpServers": {
"mcp-conf": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/r3-yamauchi/mcp-conf-mcp-server.git",
"mcp-conf-mcp-server"
]
}
}
}Claude Desktop
{
"mcpServers": {
"mcp-conf-claude": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/r3-yamauchi/mcp-conf-mcp-server.git",
"mcp-conf-mcp-server"
],
"env": {
"MCP_CONFIG_PATH": "~/Library/Application Support/Claude/claude_desktop_config.json"
}
}
}
}Claude Desktop — Windows
{
"mcpServers": {
"mcp-conf": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/r3-yamauchi/mcp-conf-mcp-server.git",
"mcp-conf-mcp-server"
],
"env": {
"MCP_CONFIG_PATH": "%APPDATA%\\Claude\\claude_desktop_config.json"
}
}
}
}