MCP Configuration Editor
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Configuration Editor add a new MCP server called 'weather' with command 'uvx' and args for the weather package"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP設定エディター
AWS Q DeveloperおよびClaude DesktopのMCP(Model Context Protocol)設定ファイルを管理するためのMCPサーバーです。設定ファイルの読み込み、編集、検証を安全に行うことができます。
特徴
🔧 設定管理: MCPサーバーの追加、更新、削除が簡単に
🔍 検証機能: 設定ファイルの構造と内容を自動検証
💾 自動バックアップ: 設定変更時に自動的にバックアップを作成
🔐 安全な操作: アトミックなファイル書き込みでデータを保護
🌍 環境変数サポート: カスタム設定ファイルパスの指定が可能
📊 詳細なロギング: すべての操作を追跡可能
Related MCP server: MCP Server Generator
インストール
uvxを使用する方法(推奨)
~/.aws/amazonq/mcp.json(またはカスタムパス)に以下を追加します:
{
"mcpServers": {
"mcp-conf": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/r3-yamauchi/mcp-conf-mcp-server.git",
"mcp-conf-mcp-server"
]
}
}
}環境変数について
設定ファイルのパスやバックアップディレクトリをカスタマイズできます:
環境変数 | 説明 | デフォルト値 |
MCP_CONFIG_PATH | MCP設定ファイルのパス |
|
MCP_BACKUP_DIR | バックアップディレクトリのパス | 設定ファイルと同じディレクトリの |
環境変数を指定する場合
カスタム設定ファイルパスやバックアップディレクトリを指定したい場合:
{
"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": "/path/to/custom/mcp.json",
"MCP_BACKUP_DIR": "/path/to/custom/backups"
}
}
}
}Claude Desktop向けの設定例
Claude Desktopの設定ファイルを管理する場合(~/Library/Application Support/Claude/claude_desktop_config.jsonに追加):
{
"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"
}
}
}
}注:~(チルダ)は自動的にホームディレクトリに展開されるため、ユーザー名の指定は不要です。
Windows向けの設定例
Windowsの場合(%APPDATA%\Claude\claude_desktop_config.jsonに追加):
{
"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"
}
}
}
}注:Windowsでは環境変数(%APPDATA%、%USERPROFILE%等)が自動的に展開されます。
手動インストール
# リポジトリをクローン
git clone https://github.com/r3-yamauchi/mcp-conf-mcp-server.git
cd mcp-conf-mcp-server
# 仮想環境を作成(推奨)
python3 -m venv venv
# アクティベート
# macOS/Linux:
source venv/bin/activate
# Windows:
venv\Scripts\activate
# インストール
pip install -e .
# サーバーを実行
mcp-conf-mcp-server使用例
# AWS Q Developer(デフォルト)
mcp-conf-mcp-server
# Claude Desktop向け
MCP_CONFIG_PATH="$HOME/Library/Application Support/Claude/claude_desktop_config.json" mcp-conf-mcp-server
# カスタムバックアップディレクトリも指定
MCP_CONFIG_PATH=/path/to/custom/mcp.json MCP_BACKUP_DIR=/path/to/backups mcp-conf-mcp-server対応する設定ファイル
このMCPサーバーは以下の設定ファイルに対応しています:
macOS/Linux
AWS Q Developer:
~/.aws/amazonq/mcp.jsonClaude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
AWS Q Developer:
%USERPROFILE%\.aws\amazonq\mcp.jsonClaude Desktop:
%APPDATA%\Claude\claude_desktop_config.json
カスタムパス
環境変数
MCP_CONFIG_PATHで任意のパスを指定可能Unix形式(
~)とWindows形式(%USERPROFILE%、%APPDATA%等)の両方に対応
利用可能なツール
📋 list_servers
設定されている全てのMCPサーバーを一覧表示します。
例:
/mcp list_servers🔍 get_server
特定のMCPサーバーの設定を取得します。
パラメータ:
name(string, 必須): サーバーの名前
例:
/mcp get_server name="my-server"➕ add_server
新しいMCPサーバー設定を追加します。
パラメータ:
name(string, 必須): サーバーの名前command(string, 必須): 実行するコマンドargs(array, オプション): コマンドライン引数env(object, オプション): 環境変数
例:
/mcp add_server name="my-server" command="uvx" args=["--from", "git+https://github.com/user/repo.git", "package-name"]🔄 update_server
既存のMCPサーバー設定を更新します。
パラメータ:
name(string, 必須): サーバーの名前command(string, オプション): 新しいコマンドargs(array, オプション): 新しい引数env(object, オプション): 追加/更新する環境変数replace_env(boolean, オプション): 環境変数を完全に置き換える場合はtrue
例:
# コマンドを更新
/mcp update_server name="my-server" command="python"
# 環境変数を追加(既存の環境変数とマージ)
/mcp update_server name="my-server" env={"API_KEY": "secret", "DEBUG": "true"}
# 環境変数を完全に置き換え
/mcp update_server name="my-server" env={"NEW_VAR": "value"} replace_env=true❌ remove_server
MCPサーバー設定を削除します。
パラメータ:
name(string, 必須): サーバーの名前
例:
/mcp remove_server name="my-server"✅ validate_config
現在のMCP設定ファイルを検証します。
例:
/mcp validate_config📤 export_config
MCP設定全体をJSON形式でエクスポートします。
例:
/mcp export_config使用例
基本的なワークフロー
# 1. 現在の設定を確認
/mcp list_servers
# 2. 新しいサーバーを追加
/mcp add_server name="code-analyzer" command="uvx" args=["--from", "git+https://github.com/example/analyzer.git", "analyzer"]
# 3. 環境変数を設定
/mcp update_server name="code-analyzer" env={"ANALYSIS_LEVEL": "detailed"}
# 4. 設定を検証
/mcp validate_config
# 5. 設定をエクスポート(バックアップ用)
/mcp export_configWindows環境での使用例
Windows環境で環境変数を使用する場合:
# コマンドプロンプト
set MCP_CONFIG_PATH=%APPDATA%\Claude\claude_desktop_config.json
mcp-conf-mcp-server
# PowerShell
$env:MCP_CONFIG_PATH = "$env:APPDATA\Claude\claude_desktop_config.json"
mcp-conf-mcp-server開発
セットアップ
# 開発依存関係をインストール
pip install -e ".[dev]"コマンド
# テストを実行
pytest
pytest -v # 詳細表示
# コード品質チェック
ruff format . # フォーマット
ruff check . # リント
mypy src # 型チェックプロジェクト構造
mcp-conf-mcp-server/
├── src/
│ └── mcp_conf_mcp_server/
│ ├── __init__.py # パッケージ初期化
│ ├── __main__.py # エントリーポイント
│ └── server.py # MCPサーバー実装
├── tests/
│ ├── test_server.py # 基本機能テスト
│ └── test_edge_cases.py # エッジケーステスト
├── pyproject.toml # プロジェクト設定
├── README.md # このファイル
├── CLAUDE.md # 開発者向けドキュメント
└── LICENSE # MITライセンスアーキテクチャ
主要コンポーネント
MCPサーバー実装: FastMCPフレームワークを使用
設定管理: Pydanticモデルによる型安全な設定
バックアップシステム: タイムスタンプ付き自動バックアップ
エラーハンドリング: 包括的な例外処理とロギング
セキュリティ機能
アトミックなファイル書き込み(データ破損を防止)
設定変更前の自動バックアップ
JSONスキーマ検証
詳細なエラーメッセージとログ
トラブルシューティング
よくある問題
設定ファイルが見つからない
ファイルパスを確認:
echo $MCP_CONFIG_PATHデフォルトパス:
~/.aws/amazonq/mcp.json
権限エラー
ファイルの権限を確認:
ls -la ~/.aws/amazonq/mcp.json必要に応じて権限を修正:
chmod 644 ~/.aws/amazonq/mcp.json
JSONパースエラー
validate_configツールで検証バックアップから復元可能
貢献
プルリクエストを歓迎します!以下のガイドラインに従ってください:
フォークしてフィーチャーブランチを作成
テストを追加(既存のテストがパスすることを確認)
コードフォーマットを実行(
ruff format)プルリクエストを送信
ライセンス
MIT License - 詳細はLICENSEファイルを参照してください。
作者
GitHub: @r3-yamauchi
Available Tools
7 toolsadd_serverA
新しいMCPサーバー設定を追加する。
既に同名のサーバーが存在する場合はエラーを返します。
Args:
name: 新しいサーバーの名前
command: 実行するコマンド
args: コマンドライン引数(オプション)
env: 環境変数(オプション)
Returns:
Dict[str, Any]: 成功メッセージと追加されたサーバー情報、またはエラー情報
Inputs: name (required), command (required), args, env.
export_configA
MCP設定全体をJSON形式でエクスポートする。
現在の設定を表示や別の場所へのコピー用に取得します。
Returns:
Dict[str, Any]: 設定全体と設定ファイルパスを含む辞書
- config: 現在の設定の完全な内容
- config_path: 設定ファイルのパス
Inputs: no named parameters.
get_serverB
特定のMCPサーバーの設定を取得する。
Args:
name: 取得するサーバーの名前
Returns:
Dict[str, Any]: サーバーの設定情報、またはエラー情報
Inputs: name (required).
list_serversA
設定されている全てのMCPサーバーをリスト表示する。
Returns:
Dict[str, Any]: サーバーのリストと設定ファイルのパスを含む辞書
- servers: 各サーバーの設定情報のリスト
- config_path: 設定ファイルのパス
Inputs: no named parameters.
remove_serverC
MCPサーバー設定を削除する。
Args:
name: 削除するサーバーの名前
Returns:
Dict[str, Any]: 成功メッセージと残りのサーバーリスト、またはエラー情報
Inputs: name (required).
update_serverA
既存のMCPサーバー設定を更新する。
指定されたフィールドのみが更新されます。
Args:
name: 更新するサーバーの名前
command: 新しいコマンド(オプション)
args: 新しい引数リスト(オプション)
env: 追加/更新する環境変数(オプション)
replace_env: Trueの場合、環境変数を完全に置き換える(デフォルト: False)
Returns:
Dict[str, Any]: 成功メッセージと更新されたサーバー情報、またはエラー情報
Inputs: name (required), command, args, env, +1 more.
validate_configA
現在のMCP設定ファイルを検証する。
設定ファイルの存在、JSON形式の妥当性、各サーバー設定の
必須フィールドをチェックします。
Returns:
Dict[str, Any]: 検証結果を含む辞書
- valid: 検証が成功したかどうか
- servers_count: サーバー数
- servers: サーバー名のリスト
- issues: 見つかった問題のリスト(ある場合)
- error: エラーメッセージ(ある場合)
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no ambiguity. The tools cover specific operations like adding, listing, getting, updating, removing servers, exporting config, and validating config - each targeting a unique action on the MCP configuration domain.
All tools follow a consistent verb_noun pattern with snake_case naming throughout (e.g., add_server, list_servers, validate_config). The naming convention is predictable and uniform across all seven tools.
Seven tools is well-scoped for an MCP configuration editor server. This provides complete CRUD operations for server configurations plus utility functions for export and validation, with each tool earning its place in the set.
The tool surface provides complete coverage for the MCP configuration domain with full CRUD lifecycle management (add, get, update, remove, list) plus essential utilities for export and validation. There are no obvious gaps or dead ends for agents working with server configurations.
Maintenance
Related MCP Connectors
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP gateway and cloud hosting for MCP servers, agents and apps like RAG, managed from your agent.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseAqualityFmaintenanceA tool that helps manage and synchronize MCP server configurations across different AI assistant clients (Cline, Roo Code, WindSurf, Claude), automating the process of retrieving, listing, adding, and removing server configurations from client configuration files.610 npm1MIT
- AlicenseNot gradedqualityDmaintenanceCreates, manages, and registers custom MCP servers for Claude Desktop. Enables users to generate and configure new MCP servers through natural language.11MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to manage MCP server configurations, including listing, enabling, disabling, and version control.10MIT
- FlicenseAqualityCmaintenanceManages, edits, backups, and validates Claude Desktop and other client JSON configurations.5-