MCP Configuration Editor

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_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开发人员: ~/.aws/amazonq/mcp.json
• 克劳德桌面: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗

• AWS Q开发人员: %USERPROFILE%\.aws\amazonq\mcp.json
• 克劳德桌面: %APPDATA%\Claude\claude_desktop_config.json

自定义路径

• 环境变数 MCP_CONFIG_PATH 可在中指定任意路径
• Unix形式（~）和Windows格式（%USERPROFILE%、%APPDATA%等）双方对应

可用工具

📋 list_server

所有设定的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

1. 权限错误

- 验证文件权限： ls -la ~/.aws/amazonq/mcp.json - 根据需要修改权限： chmod 644 ~/.aws/amazonq/mcp.json

1. JSON珀斯误差

- validate_config工具验证 - 可从备份恢复

貢献

欢迎拉式点播！请遵循以下准则：

1. 通过分叉创建特征分支
2. 添加测试（验证现有测试是否通过）
3. 执行代码格式（ruff format）
4. 发送拉式请求

许可证

MIT License - 了解更多信息许可证请参见文件。

作者

• github： @r3 yamauchi