MCP Configuration Editor

Edite o arquivo de configuração mcp.json para ferramentas como AWS Q Developer e Claude Desktop.

GitHubExperimente este MCPPatrocinado

Documentação

Editor de Configuração MCP

Servidor MCP (Model Context Protocol) para gerenciar arquivos de configuração do AWS Q Developer e Claude Desktop. Permite carregar, editar e validar arquivos de configuração com segurança.

Recursos

  • 🔧 Gerenciamento de Configuração: Adicione, atualize e remova servidores MCP facilmente
  • 🔍 Validação: Valida automaticamente a estrutura e o conteúdo dos arquivos de configuração
  • 💾 Backup Automático: Cria backups automaticamente ao alterar configurações
  • 🔐 Operação Segura: Escrita atômica de arquivos para proteger dados
  • 🌍 Suporte a Variáveis de Ambiente: Permite especificar caminhos personalizados de arquivos de configuração
  • 📊 Registro Detalhado: Rastreie todas as operações

Instalação

Usando uvx (recomendado)

Adicione o seguinte a ~/.aws/amazonq/mcp.json (ou caminho personalizado):

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

Sobre Variáveis de Ambiente

Você pode personalizar o caminho do arquivo de configuração e o diretório de backup:

Variável de AmbienteDescriçãoValor Padrão
MCP_CONFIG_PATHCaminho do arquivo de configuração MCP~/.aws/amazonq/mcp.json
MCP_BACKUP_DIRCaminho do diretório de backupbackups/ no mesmo diretório do arquivo de configuração
Exemplo: ~/.aws/amazonq/backups/

Ao especificar variáveis de ambiente

Se desejar especificar um caminho de arquivo de configuração personalizado ou diretório de backup:

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

Exemplo de configuração para Claude Desktop

Ao gerenciar o arquivo de configuração do Claude Desktop (adicionar 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: ~ (til) é expandido automaticamente para o diretório home, portanto não é necessário especificar o nome de usuário.

Exemplo de configuração para Windows

No caso do Windows (adicionar 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: No Windows, variáveis de ambiente (%APPDATA%, %USERPROFILE%, etc.) são expandidas automaticamente.

Instalação 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

Exemplo 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

Arquivos de Configuração Suportados

Este servidor MCP suporta os seguintes arquivos de configuração:

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

Caminhos Personalizados

  • Especifique qualquer caminho com a variável de ambiente MCP_CONFIG_PATH
  • Suporta formatos Unix (~) e Windows (%USERPROFILE%, %APPDATA%, etc.)

Ferramentas Disponíveis

📋 list_servers

Lista todos os servidores MCP configurados.

Exemplo:

/mcp list_servers

🔍 get_server

Obtém a configuração de um servidor MCP específico.

Parâmetros:

  • name (string, obrigatório): Nome do servidor

Exemplo:

/mcp get_server name="my-server"

➕ add_server

Adiciona uma nova configuração de servidor MCP.

Parâmetros:

  • name (string, obrigatório): Nome do servidor
  • command (string, obrigatório): Comando a ser executado
  • args (array, opcional): Argumentos de linha de comando
  • env (object, opcional): Variáveis de ambiente

Exemplo:

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

🔄 update_server

Atualiza uma configuração de servidor MCP existente.

Parâmetros:

  • name (string, obrigatório): Nome do servidor
  • command (string, opcional): Novo comando
  • args (array, opcional): Novos argumentos
  • env (object, opcional): Variáveis de ambiente para adicionar/atualizar
  • replace_env (boolean, opcional): true para substituir completamente as variáveis de ambiente

Exemplo:

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

Remove uma configuração de servidor MCP.

Parâmetros:

  • name (string, obrigatório): Nome do servidor

Exemplo:

/mcp remove_server name="my-server"

✅ validate_config

Valida o arquivo de configuração MCP atual.

Exemplo:

/mcp validate_config

📤 export_config

Exporta toda a configuração MCP em formato JSON.

Exemplo:

/mcp export_config

Exemplos de Uso

Fluxo de Trabalho 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

Exemplo de Uso no Windows

Ao usar variáveis de ambiente no 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

Desenvolvimento

Configuração

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

Comandos

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

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

Estrutura do Projeto

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

Arquitetura

Componentes Principais

  • Implementação do Servidor MCP: Usa o framework FastMCP
  • Gerenciamento de Configuração: Configuração type-safe com modelos Pydantic
  • Sistema de Backup: Backup automático com carimbo de data/hora
  • Tratamento de Erros: Tratamento abrangente de exceções e registro

Recursos de Segurança

  • Escrita atômica de arquivos (evita corrupção de dados)
  • Backup automático antes de alterações de configuração
  • Validação de esquema JSON
  • Mensagens de erro e registros detalhados

Solução de Problemas

Problemas Comuns

  1. Arquivo de configuração não encontrado

    • Verifique o caminho do arquivo: echo $MCP_CONFIG_PATH
    • Caminho padrão: ~/.aws/amazonq/mcp.json

  2. Erro de permissão

    • Verifique as permissões do arquivo: ls -la ~/.aws/amazonq/mcp.json
    • Corrija as permissões conforme necessário: chmod 644 ~/.aws/amazonq/mcp.json

  3. Erro de análise JSON

    • Valide com a ferramenta validate_config
    • Possível restauração a partir do backup

Contribuição

Pull requests são bem-vindos! Siga as diretrizes abaixo:

  1. Faça um fork e crie um branch de recurso
  2. Adicione testes (verifique se os testes existentes passam)
  3. Execute a formatação de código (ruff format)
  4. Envie um pull request

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes.

Autor