MCP Configuration Editor

Edit the mcp.json configuration file for tools like AWS Q Developer and Claude Desktop.

GitHub

MCP設定エディター

AWS Q DeveloperおよびClaude DesktopのMCP（Model Context Protocol）設定ファイルを管理するためのMCPサーバーです。設定ファイルの読み込み、編集、検証を安全に行うことができます。

特徴

  • 🔧 設定管理: MCPサーバーの追加、更新、削除が簡単に
  • 🔍 検証機能: 設定ファイルの構造と内容を自動検証
  • 💾 自動バックアップ: 設定変更時に自動的にバックアップを作成
  • 🔐 安全な操作: アトミックなファイル書き込みでデータを保護
  • 🌍 環境変数サポート: カスタム設定ファイルパスの指定が可能
  • 📊 詳細なロギング: すべての操作を追跡可能

インストール

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_PATHMCP設定ファイルのパス~/.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ファイルを参照してください。

作者

Servidores relacionados