Skip to main content
Glama
MCP Configuration Editor

MCP Configuration Editor

by r3-yamauchi

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設定ファイルのパス

~/.aws/amazonq/mcp.json

MCP_BACKUP_DIR

バックアップディレクトリのパス

設定ファイルと同じディレクトリの backups/例: ~/.aws/amazonq/backups/

環境変数を指定する場合

カスタム設定ファイルパスやバックアップディレクトリを指定したい場合:

{
  "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.json

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

  • AWS Q Developer: %USERPROFILE%\.aws\amazonq\mcp.json

  • Claude 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_config

Windows環境での使用例

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スキーマ検証

  • 詳細なエラーメッセージとログ

トラブルシューティング

よくある問題

  1. 設定ファイルが見つからない

    • ファイルパスを確認: echo $MCP_CONFIG_PATH

    • デフォルトパス: ~/.aws/amazonq/mcp.json

  2. 権限エラー

    • ファイルの権限を確認: ls -la ~/.aws/amazonq/mcp.json

    • 必要に応じて権限を修正: chmod 644 ~/.aws/amazonq/mcp.json

  3. JSONパースエラー

    • validate_configツールで検証

    • バックアップから復元可能

貢献

プルリクエストを歓迎します!以下のガイドラインに従ってください:

  1. フォークしてフィーチャーブランチを作成

  2. テストを追加(既存のテストがパスすることを確認)

  3. コードフォーマットを実行(ruff format)

  4. プルリクエストを送信

ライセンス

MIT License - 詳細はLICENSEファイルを参照してください。

作者

Available Tools

7 tools
add_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

    A3.9/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      A 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.
      6
      10 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Creates, manages, and registers custom MCP servers for Claude Desktop. Enables users to generate and configure new MCP servers through natural language.
      11
      MIT