MCP Configuration Editor

Edita el archivo de configuración mcp.json para herramientas como AWS Q Developer y Claude Desktop.

Documentación

Editor de Configuración MCP

Servidor MCP (Model Context Protocol) para gestionar los archivos de configuración de AWS Q Developer y Claude Desktop. Permite cargar, editar y validar archivos de configuración de forma segura.

Características

🔧 Gestión de configuración: Agregar, actualizar y eliminar servidores MCP fácilmente
🔍 Función de validación: Valida automáticamente la estructura y el contenido de los archivos de configuración
💾 Copia de seguridad automática: Crea copias de seguridad automáticamente al cambiar la configuración
🔐 Operación segura: Protege los datos con escritura atómica de archivos
🌍 Soporte de variables de entorno: Permite especificar rutas de archivos de configuración personalizadas
📊 Registro detallado: Permite rastrear todas las operaciones

Instalación

Método con uvx (recomendado)

Agregue lo siguiente a ~/.aws/amazonq/mcp.json (o ruta personalizada):

{
  "mcpServers": {
    "mcp-conf": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/r3-yamauchi/mcp-conf-mcp-server.git",
        "mcp-conf-mcp-server"
      ]
    }
  }
}

Acerca de las variables de entorno

Puede personalizar la ruta del archivo de configuración y el directorio de copias de seguridad:

Variable de entorno	Descripción	Valor predeterminado
MCP_CONFIG_PATH	Ruta del archivo de configuración MCP	`~/.aws/amazonq/mcp.json`
MCP_BACKUP_DIR	Ruta del directorio de copias de seguridad	`backups/` en el mismo directorio que el archivo de configuración Ejemplo: `~/.aws/amazonq/backups/`

Al especificar variables de entorno

Si desea especificar una ruta de archivo de configuración personalizada o un directorio de copias de seguridad:

{
  "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"
      }
    }
  }
}

Ejemplo de configuración para Claude Desktop

Al gestionar el archivo de configuración de Claude Desktop (agregar a ~/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"
      }
    }
  }
}

Nota: ~ (tilde) se expande automáticamente al directorio de inicio, por lo que no es necesario especificar el nombre de usuario.

Ejemplo de configuración para Windows

En el caso de Windows (agregar a %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"
      }
    }
  }
}

Nota: En Windows, las variables de entorno (%APPDATA%, %USERPROFILE%, etc.) se expanden automáticamente.

Instalación manual

# リポジトリをクローン
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

Ejemplo de uso

# 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

Archivos de configuración compatibles

Este servidor MCP es compatible con los siguientes archivos de configuración:

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

Rutas personalizadas

Se puede especificar cualquier ruta con la variable de entorno MCP_CONFIG_PATH
Compatible con formato Unix (~) y formato Windows (%USERPROFILE%, %APPDATA%, etc.)

Herramientas disponibles

📋 list_servers

Muestra una lista de todos los servidores MCP configurados.

Ejemplo:

/mcp list_servers

🔍 get_server

Obtiene la configuración de un servidor MCP específico.

Parámetros:

name (string, obligatorio): Nombre del servidor

Ejemplo:

/mcp get_server name="my-server"

➕ add_server

Agrega una nueva configuración de servidor MCP.

Parámetros:

name (string, obligatorio): Nombre del servidor
command (string, obligatorio): Comando a ejecutar
args (array, opcional): Argumentos de línea de comandos
env (object, opcional): Variables de entorno

Ejemplo:

/mcp add_server name="my-server" command="uvx" args=["--from", "git+https://github.com/user/repo.git", "package-name"]

🔄 update_server

Actualiza la configuración de un servidor MCP existente.

Parámetros:

name (string, obligatorio): Nombre del servidor
command (string, opcional): Nuevo comando
args (array, opcional): Nuevos argumentos
env (object, opcional): Variables de entorno para agregar/actualizar
replace_env (boolean, opcional): true para reemplazar completamente las variables de entorno

Ejemplo:

# コマンドを更新
/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

Elimina la configuración de un servidor MCP.

Parámetros:

name (string, obligatorio): Nombre del servidor

Ejemplo:

/mcp remove_server name="my-server"

✅ validate_config

Valida el archivo de configuración MCP actual.

Ejemplo:

/mcp validate_config

📤 export_config

Exporta toda la configuración MCP en formato JSON.

Ejemplo:

/mcp export_config

Ejemplos de uso

Flujo de trabajo básico

# 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

Ejemplo de uso en entorno Windows

Al usar variables de entorno en un entorno 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

Desarrollo

Configuración

# 開発依存関係をインストール
pip install -e ".[dev]"

Comandos

# テストを実行
pytest
pytest -v  # 詳細表示

# コード品質チェック
ruff format .  # フォーマット
ruff check .   # リント
mypy src       # 型チェック

Estructura del proyecto

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ライセンス

Arquitectura

Componentes principales

Implementación del servidor MCP: Utiliza el framework FastMCP
Gestión de configuración: Configuración con seguridad de tipos mediante modelos Pydantic
Sistema de copias de seguridad: Copias de seguridad automáticas con marca de tiempo
Manejo de errores: Manejo integral de excepciones y registro

Funciones de seguridad

Escritura atómica de archivos (previene la corrupción de datos)
Copia de seguridad automática antes de cambios de configuración
Validación de esquema JSON
Mensajes de error y registros detallados

Solución de problemas

Problemas comunes

No se encuentra el archivo de configuración
- Verifique la ruta del archivo: echo $MCP_CONFIG_PATH
- Ruta predeterminada: ~/.aws/amazonq/mcp.json
Error de permisos
- Verifique los permisos del archivo: ls -la ~/.aws/amazonq/mcp.json
- Corrija los permisos si es necesario: chmod 644 ~/.aws/amazonq/mcp.json
Error de análisis JSON
- Valide con la herramienta validate_config
- Se puede restaurar desde la copia de seguridad

Contribuciones

¡Se aceptan solicitudes de extracción (pull requests)! Siga las siguientes pautas:

Cree un fork y una rama de características
Agregue pruebas (verifique que las pruebas existentes pasen)
Ejecute el formato de código (ruff format)
Envíe la solicitud de extracción

Licencia

Licencia MIT: consulte el archivo LICENSE para más detalles.

Autor

GitHub: @r3-yamauchi