Nginx Proxy Manager MCP

Instructions

Implementation Reference

• src/npm_mcp/client.py:378-381 (handler)

  Implementation of the get_setting tool in the NPMClient class, including validation.

  async def get_setting(self, setting_id: str) -> Setting:
      setting_id = _validate_setting_id(setting_id)
      response = await self._request("GET", f"/api/settings/{setting_id}")
      return Setting(**response.json())

• src/npm_mcp/server.py:513-514 (handler)

  Tool handler registration and execution call for get_setting in server.py.

  elif name == "get_setting":
      return _model_response(await npm_client.get_setting(arguments["setting_id"]))

• src/npm_mcp/server.py:308-315 (schema)

  Tool definition/registration for get_setting with its input schema.

      name="get_setting",
      description="Get a specific setting by ID",
      inputSchema={
          "type": "object",
          "properties": {"setting_id": {"type": "string", "description": "The setting ID (e.g. 'default-site')"}},
          "required": ["setting_id"],
      },
  ),

• src/npm_mcp/client.py:43-48 (helper)

  Validation helper for setting_id.

  def _validate_setting_id(value) -> str:
      """Validate setting_id is a safe alphanumeric-dash string."""
      s = str(value)
      if not _SETTING_ID_PATTERN.match(s):
          raise ValueError(f"setting_id must match [a-z0-9-]{{1,64}}, got: {s!r}")
      return s