MCP Configuration Editor

Instructions

既に同名のサーバーが存在する場合はエラーを返します。

Args:
    name: 新しいサーバーの名前
    command: 実行するコマンド
    args: コマンドライン引数（オプション）
    env: 環境変数（オプション）

Returns:
    Dict[str, Any]: 成功メッセージと追加されたサーバー情報、またはエラー情報

Implementation Reference

• src/mcp_conf_mcp_server/server.py:203-251 (handler)

  The core handler function for the 'add_server' tool. It registers the tool via @mcp.tool decorator, validates input, creates a new ServerConfig, adds it to the MCPConfig, saves to file, and returns success/error details.

  @mcp.tool(name="add_server")
  async def add_server(
      name: str, command: str, args: Optional[list[str]] = None, env: Optional[Dict[str, str]] = None
  ) -> Dict[str, Any]:
      """新しいMCPサーバー設定を追加する。
  
      既に同名のサーバーが存在する場合はエラーを返します。
  
      Args:
          name: 新しいサーバーの名前
          command: 実行するコマンド
          args: コマンドライン引数（オプション）
          env: 環境変数（オプション）
  
      Returns:
          Dict[str, Any]: 成功メッセージと追加されたサーバー情報、またはエラー情報
      """
      config = load_config()
  
      if name in config.mcpServers:
          # 同名のサーバーが既に存在する場合はエラーを返す
          logger.warning(f"Attempted to add duplicate server: {name}")
          return {
              "error": f"Server '{name}' already exists",
              "hint": "Use update_server to modify existing configuration",
          }
  
      # 新しいサーバー設定を作成
      server_config = ServerConfig(command=command, args=args or [], env=env)
  
      # 設定に追加して保存
      config.mcpServers[name] = server_config
  
      try:
          save_config(config)
          logger.info(f"Successfully added server: {name}")
          return {
              "message": f"Server '{name}' added successfully",
              "server": {
                  "name": name,
                  "command": server_config.command,
                  "args": server_config.args,
                  "env": server_config.env,
              },
          }
      except Exception as e:
          logger.error(f"Failed to save configuration after adding server {name}: {e}")
          return {"error": f"Failed to save configuration: {str(e)}", "hint": "Check file permissions and disk space"}

• src/mcp_conf_mcp_server/server.py:39-51 (schema)

  Pydantic schema/model for individual server configuration, directly instantiated in add_server handler with provided args.

  class ServerConfig(BaseModel):
      """MCPサーバーの設定を表すモデル。
  
      Attributes:
          command: 実行するコマンド（例: "python", "uvx", "node"）
          args: コマンドライン引数のリスト
          env: 環境変数の辞書（オプション）
      """
  
      command: str
      args: list[str] = Field(default_factory=list)
      env: Optional[Dict[str, str]] = None

• src/mcp_conf_mcp_server/server.py:53-61 (schema)

  Pydantic schema/model for the overall MCP configuration file structure, loaded and modified in add_server.

  class MCPConfig(BaseModel):
      """mcp.json設定ファイルの構造を表すモデル。
  
      Attributes:
          mcpServers: サーバー名をキーとし、ServerConfigを値とする辞書
      """
  
      mcpServers: Dict[str, ServerConfig] = Field(default_factory=dict)

• src/mcp_conf_mcp_server/server.py:121-157 (helper)

  Helper function to persist the MCPConfig to JSON file, called by add_server after modification. Handles backups and atomic saves.

  def save_config(config: MCPConfig, create_backup_file: bool = True) -> None:
      """MCP設定をディスクに保存する。
  
      必要に応じて親ディレクトリを作成し、設定をJSON形式で保存します。
      Noneの値は除外され、読みやすいように2スペースでインデントされます。
  
      Args:
          config: 保存するMCP設定
          create_backup_file: 保存前にバックアップを作成するかどうか
  
      Raises:
          Exception: 保存に失敗した場合
      """
      try:
          # バックアップを作成
          if create_backup_file and CONFIG_PATH.exists():
              try:
                  create_backup()
              except Exception as e:
                  logger.warning(f"Failed to create backup, continuing with save: {e}")
  
          # 親ディレクトリが存在しない場合は作成
          CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
  
          # 一時ファイルに書き込んでからアトミックに置き換え
          temp_path = CONFIG_PATH.with_suffix(".tmp")
          with open(temp_path, "w") as f:
              json.dump(config.model_dump(exclude_none=True), f, indent=2)
              f.write("\n")  # 最後に改行を追加
  
          # アトミックに置き換え
          temp_path.replace(CONFIG_PATH)
          logger.info(f"Configuration saved successfully to {CONFIG_PATH}")
      except Exception as e:
          logger.error(f"Failed to save configuration: {e}")
          raise

• src/mcp_conf_mcp_server/server.py:63-93 (helper)

  Helper function to load and parse the MCP config from file, called first in add_server.

  def load_config() -> MCPConfig:
      """現在のMCP設定を読み込む。
  
      設定ファイルが存在しない場合や読み込みエラーが発生した場合は、
      空の設定を返します。
  
      Returns:
          MCPConfig: 読み込まれた設定、またはデフォルトの空設定
      """
      if not CONFIG_PATH.exists():
          # 設定ファイルが存在しない場合は空の設定を返す
          logger.info(f"Configuration file not found at {CONFIG_PATH}")
          return MCPConfig()
  
      try:
          with open(CONFIG_PATH, "r") as f:
              data = json.load(f)
          config = MCPConfig(**data)
          logger.debug(f"Loaded configuration with {len(config.mcpServers)} servers")
          return config
      except json.JSONDecodeError as e:
          logger.error(f"Failed to parse JSON configuration: {e}")
          # エラーが発生した場合も空の設定を返す（既存の設定を破壊しない）
          return MCPConfig()
      except ValidationError as e:
          logger.error(f"Configuration validation failed: {e}")
          return MCPConfig()
      except Exception as e:
          logger.error(f"Unexpected error loading configuration: {e}")
          return MCPConfig()