使用说明

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架构验证
详细的错误消息和日志

故障排除

常见问题

找不到配置文件
- 检查文件路径： echo $MCP_CONFIG_PATH
- 默认路径： ~/.aws/amazonq/mcp.json
权限错误
- 验证文件权限： ls -la ~/.aws/amazonq/mcp.json
- 根据需要修改权限： chmod 644 ~/.aws/amazonq/mcp.json
JSON珀斯误差
- validate_config工具验证
- 可从备份恢复

貢献

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

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

许可证

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

作者

github： @r3 yamauchi

使用说明

MCP配置编辑器

特徴

安装

uvx使用（建议）

关于环境变量

指定环境变量时

Claude Desktop面向的设置示例

Windows面向的设置示例

手动安装

使用例

对应的配置文件

macOS/Linux

视窗

自定义路径

可用工具

📋 list_server

🔍 get_server

➕ add_server

🔄 update_server

❌ remove_server

✅ validate_config

📤 export_config

使用例

基本工作流

Windows环境示例

开発

安装，安装

命令

项目结构

体系结构

主要组件

安全功能

故障排除

常见问题

貢献

许可证

作者

相关 MCP

终端控制服务

Kubernetes安全操作服务器

YAML-MCP服务器

Git服务器工具

意式浓缩咖啡配置管理服务器

SSH命令服务器