arch-mcp

Instructions

Implementation Reference

• src/arch_ops_server/config.py:317-362 (handler)

  The primary handler function implementing the tool logic. It checks if running on Arch Linux, analyzes pacman.conf for parallel_downloads setting, generates recommendations based on the value, logs the action, and returns a structured dictionary with the setting, default status, and recommendations. Handles errors gracefully.
  async def get_parallel_downloads_setting() -> Dict[str, Any]: """ Get parallel downloads configuration. Returns: Dict with parallel downloads setting and recommendations """ if not IS_ARCH: return create_error_response( "NotSupported", "This feature is only available on Arch Linux" ) logger.info("Checking parallel downloads setting") try: result = await analyze_pacman_conf() if "error" in result: return result parallel_downloads = result.get("parallel_downloads", 1) # Recommendations recommendations = [] if parallel_downloads == 1: recommendations.append("Consider increasing ParallelDownloads to 3-5 for faster updates") elif parallel_downloads > 10: recommendations.append("Very high ParallelDownloads may strain mirrors; consider reducing to 5-7") logger.info(f"Parallel downloads: {parallel_downloads}") return { "parallel_downloads": parallel_downloads, "is_default": parallel_downloads == 1, "recommendations": recommendations } except Exception as e: logger.error(f"Failed to check parallel downloads: {e}") return create_error_response( "ConfigCheckError", f"Failed to check parallel downloads setting: {str(e)}" )
• src/arch_ops_server/server.py:1139-1146 (registration)

  Tool registration in the @server.list_tools() function. Defines the tool name, description, and empty input schema (no parameters required). This makes the tool discoverable to MCP clients.
  Tool( name="get_parallel_downloads_setting", description="[CONFIG] Get parallel downloads configuration from pacman.conf and provide recommendations. Only works on Arch Linux.", inputSchema={ "type": "object", "properties": {} } ),
• src/arch_ops_server/server.py:1139-1146 (schema)

  Input schema definition for the tool: an empty object since the tool takes no parameters. Part of the Tool registration in list_tools().
  Tool( name="get_parallel_downloads_setting", description="[CONFIG] Get parallel downloads configuration from pacman.conf and provide recommendations. Only works on Arch Linux.", inputSchema={ "type": "object", "properties": {} } ),
• src/arch_ops_server/server.py:1463-1468 (registration)

  Tool invocation/dispatch in the @server.call_tool() handler. Checks Arch Linux environment, calls the get_parallel_downloads_setting function, and formats the result as JSON text content for MCP response.
  elif name == "get_parallel_downloads_setting": if not IS_ARCH: return [TextContent(type="text", text="Error: get_parallel_downloads_setting only available on Arch Linux systems")] result = await get_parallel_downloads_setting() return [TextContent(type="text", text=json.dumps(result, indent=2))]
• src/arch_ops_server/tool_metadata.py:451-459 (schema)

  Tool metadata definition categorizing it as 'config' tool for Arch platform, read permission, 'explore' workflow, with related tool analyze_pacman_conf.
  "get_parallel_downloads_setting": ToolMetadata( name="get_parallel_downloads_setting", category="config", platform="arch", permission="read", workflow="explore", related_tools=["analyze_pacman_conf"], prerequisite_tools=[] ),