arch-mcp

Instructions

Implementation Reference

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

  The main handler function implementing the tool logic. It analyzes pacman.conf to retrieve the ParallelDownloads setting, determines if it's the default value, and provides optimization recommendations.
  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)

  MCP tool registration in list_tools(), including the tool name, description, and empty input schema (no parameters required).
  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/tool_metadata.py:451-459 (schema)

  Tool metadata definition categorizing it as a config tool for Arch Linux, read-only, related to pacman.conf analysis.
  "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=[] ),
• src/arch_ops_server/server.py:1463-1468 (registration)

  Tool dispatch logic in the universal call_tool() handler that invokes the get_parallel_downloads_setting function and formats the 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))]