arch-ops-server 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

arch_ops_server/__init__.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
 """
 Arch Linux MCP Server
 

arch_ops_server/aur.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
 """
 AUR (Arch User Repository) interface module.
 Provides search, package info, and PKGBUILD retrieval via AUR RPC v5.
@@ -679,6 +680,41 @@ async def install_package_secure(package_name: str) -> Dict[str, Any]:
         "messages": []
     }
     
+    # ========================================================================
+    # STEP 0: Verify sudo is configured properly
+    # ========================================================================
+    logger.info("[STEP 0/5] Verifying sudo configuration...")
+    
+    # Test if sudo password is cached or passwordless sudo is configured
+    # Use skip_sudo_check=True to avoid recursive check
+    test_exit_code, _, test_stderr = await run_command(
+        ["sudo", "-n", "true"],
+        timeout=5,
+        check=False,
+        skip_sudo_check=True
+    )
+    
+    if test_exit_code != 0:
+        result["messages"].append("⚠️  SUDO PASSWORD REQUIRED")
+        result["messages"].append("")
+        result["messages"].append("Package installation requires sudo privileges.")
+        result["messages"].append("Please choose one of these options:")
+        result["messages"].append("")
+        result["messages"].append("Option 1: Configure passwordless sudo for pacman:")
+        result["messages"].append("  sudo visudo -f /etc/sudoers.d/arch-package-install")
+        result["messages"].append("  Add: your_username ALL=(ALL) NOPASSWD: /usr/bin/pacman")
+        result["messages"].append("")
+        result["messages"].append("Option 2: Cache sudo password temporarily:")
+        result["messages"].append("  Run: sudo -v")
+        result["messages"].append("  Then retry the installation")
+        result["messages"].append("")
+        result["messages"].append("Option 3: Install manually in terminal:")
+        result["messages"].append(f"  sudo pacman -S {package_name}")
+        result["security_checks"]["decision"] = "SUDO_REQUIRED"
+        return result
+    
+    result["messages"].append("✅ Sudo privileges verified")
+    
     # ========================================================================
     # STEP 1: Check if package is in official repos first
     # ========================================================================
@@ -714,6 +750,17 @@ async def install_package_secure(package_name: str) -> Dict[str, Any]:
                 result["messages"].append(f"❌ Installation failed: {stderr}")
                 logger.error(f"pacman installation failed: {stderr}")
                 
+                # Check for sudo password issues
+                if "password" in stderr.lower() or "sudo" in stderr.lower():
+                    result["messages"].append("")
+                    result["messages"].append("⚠️  SUDO PASSWORD REQUIRED")
+                    result["messages"].append("To enable passwordless installation, run one of these commands:")
+                    result["messages"].append("1. For passwordless sudo (less secure):")
+                    result["messages"].append("   sudo visudo -f /etc/sudoers.d/arch-package-install")
+                    result["messages"].append("   Add: your_username ALL=(ALL) NOPASSWD: /usr/bin/pacman")
+                    result["messages"].append("2. Or run the installation manually in your terminal:")
+                    result["messages"].append(f"   sudo pacman -S {package_name}")
+                
             result["install_output"] = stdout
             result["install_errors"] = stderr
             
@@ -846,6 +893,17 @@ async def install_package_secure(package_name: str) -> Dict[str, Any]:
             result["messages"].append(f"   Error: {stderr}")
             result["security_checks"]["decision"] = "INSTALL_FAILED"
             logger.error(f"AUR installation failed for {package_name}: {stderr}")
+            
+            # Check for sudo password issues
+            if "password" in stderr.lower() or "sudo" in stderr.lower():
+                result["messages"].append("")
+                result["messages"].append("⚠️  SUDO PASSWORD REQUIRED")
+                result["messages"].append("To enable passwordless installation for AUR packages:")
+                result["messages"].append("1. For passwordless sudo for pacman:")
+                result["messages"].append("   sudo visudo -f /etc/sudoers.d/arch-aur-install")
+                result["messages"].append("   Add: your_username ALL=(ALL) NOPASSWD: /usr/bin/pacman")
+                result["messages"].append("2. Or run the installation manually in your terminal:")
+                result["messages"].append(f"   {aur_helper} -S {package_name}")
         
         result["install_output"] = stdout
         result["install_errors"] = stderr

arch_ops_server/pacman.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
 """
 Pacman/Official Repository interface module.
 Provides package info and update checks with hybrid local/remote approach.

arch_ops_server/server.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
 """
 MCP Server setup for Arch Linux operations.
 
@@ -381,7 +382,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     
     elif name == "analyze_package_metadata_risk":
         package_info = arguments["package_info"]
-        result = await analyze_package_metadata_risk(package_info)
+        result = analyze_package_metadata_risk(package_info)
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
     
     else:
@@ -513,7 +514,7 @@ async def get_prompt(name: str, arguments: dict[str, str]) -> GetPromptResult:
             pkgbuild_content = await get_pkgbuild(package_name)
             
             # Analyze both metadata and PKGBUILD
-            metadata_risk = await analyze_package_metadata_risk(package_info)
+            metadata_risk = analyze_package_metadata_risk(package_info)
             pkgbuild_safety = analyze_pkgbuild_safety(pkgbuild_content)
             
             audit_summary = f"""

arch_ops_server/utils.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
 """
 Utility functions for Arch Linux MCP Server.
 Provides platform detection, subprocess execution, and error handling.
@@ -57,15 +58,20 @@ IS_ARCH = is_arch_linux()
 async def run_command(
     cmd: list[str],
     timeout: int = 10,
-    check: bool = True
+    check: bool = True,
+    skip_sudo_check: bool = False
 ) -> tuple[int, str, str]:
     """
     Execute a command asynchronously with timeout protection.
     
+    Note: For sudo commands, stdin is properly connected to allow password input
+    if passwordless sudo is not configured.
+    
     Args:
         cmd: Command and arguments as list
         timeout: Timeout in seconds (default: 10)
         check: If True, raise exception on non-zero exit code
+        skip_sudo_check: If True, skip the early sudo password check (for testing)
     
     Returns:
         Tuple of (exit_code, stdout, stderr)
@@ -76,21 +82,56 @@ async def run_command(
     """
     logger.debug(f"Executing command: {' '.join(cmd)}")
     
+    # Check if this is a sudo command and if password is cached
+    is_sudo_command = cmd and cmd[0] == "sudo"
+    if is_sudo_command and not skip_sudo_check:
+        # Test if sudo password is cached (non-interactive mode)
+        test_cmd = ["sudo", "-n", "true"]
+        try:
+            test_process = await asyncio.create_subprocess_exec(
+                *test_cmd,
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.PIPE
+            )
+            await test_process.communicate()
+            password_cached = test_process.returncode == 0
+            logger.debug(f"Sudo password cached: {password_cached}")
+            
+            if not password_cached:
+                logger.warning("Sudo password is required but not cached. "
+                              "Please run 'sudo pacman -S <package>' manually in the terminal.")
+                return (
+                    1,
+                    "",
+                    "Sudo password required. Please configure passwordless sudo for pacman/paru, "
+                    "or run the installation command manually in your terminal."
+                )
+        except Exception as e:
+            logger.warning(f"Could not check sudo status: {e}")
+            password_cached = False
+    else:
+        password_cached = True
+    
     try:
+        # Attach stdin to subprocess for commands that might need input
+        # Use asyncio.subprocess.PIPE to allow stdin interaction
         process = await asyncio.create_subprocess_exec(
             *cmd,
             stdout=asyncio.subprocess.PIPE,
-            stderr=asyncio.subprocess.PIPE
+            stderr=asyncio.subprocess.PIPE,
+            stdin=asyncio.subprocess.PIPE if is_sudo_command else None
         )
         
+        # Communicate with the process
+        # For sudo commands, this allows password input if needed
         stdout, stderr = await asyncio.wait_for(
             process.communicate(),
             timeout=timeout
         )
         
         exit_code = process.returncode
-        stdout_str = stdout.decode('utf-8', errors='replace')
-        stderr_str = stderr.decode('utf-8', errors='replace')
+        stdout_str = stdout.decode('utf-8', errors='replace') if stdout else ""
+        stderr_str = stderr.decode('utf-8', errors='replace') if stderr else ""
         
         logger.debug(f"Command exit code: {exit_code}")
         

arch_ops_server/wiki.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
 """
 Arch Wiki interface module.
 Provides search and page retrieval via MediaWiki API with BeautifulSoup fallback.

{arch_ops_server-0.1.1.dist-info → arch_ops_server-0.1.3.dist-info}/METADATA

@@ -1,15 +1,16 @@
 Metadata-Version: 2.3
 Name: arch-ops-server
-Version: 0.1.1
+Version: 0.1.3
 Summary: MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)
 Keywords: arch-linux,mcp,model-context-protocol,aur,pacman,wiki,ai-assistant
 Author: Nihal
 Author-email: Nihal <2tv8xupqg@mozmail.com>
-License: GPL-3.0
+License: GPL-3.0-only OR MIT
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
@@ -26,6 +27,10 @@ Description-Content-Type: text/markdown
 
 # Arch Linux MCP Server
 
+<a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp/badge" />
+</a>
+
 **Disclaimer:** Unofficial community project, not affiliated with Arch Linux.
 
 A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that bridges AI assistants with the Arch Linux ecosystem. Enables intelligent, safe, and efficient access to the Arch Wiki, AUR, and official repositories for AI-assisted Arch Linux usage on Arch and non-Arch systems.
@@ -36,6 +41,20 @@ Leverage AI to get  output for digestible, structured results that are ready for
 
 ## Sneak Peak into what's available
 
+<details open>
+<summary>Claude Desktop (no terminal)</summary>
+
+![Claude Desktop Demo](assets/claudedesktop_signalcli.gif)
+
+</details>
+
+<details>
+<summary>VS Code (with terminal)</summary>
+
+![VS Code Demo](assets/vscode_notesnook.gif)
+
+</details>
+
 ### Resources (URI-based Access)
 
 Direct access to Arch ecosystem data via custom URI schemes:
@@ -81,7 +100,6 @@ Direct access to Arch ecosystem data via custom URI schemes:
 ```bash
 uvx arch-ops-server
 ```
-
 ---
 
 ## Configuration
@@ -99,11 +117,17 @@ Claude / Cursor / Any MCP client that supports STDIO transport
 }
 ```
 
-## License
+## Contributing
 
-[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)
+Contributions are greatly appreciated. Please feel free to submit a pull request or open an issue and help make things better for everyone.
 
----
+[Contributing Guide](https://nxk.mintlify.app/arch-mcp/contributing)
+
+## License
+
+This project is dual-licensed under your choice of:
 
+- **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - See [LICENSE-GPL](LICENSE-GPL)
+- **[MIT License](https://opensource.org/licenses/MIT)** - See [LICENSE-MIT](LICENSE-MIT)
 
-Built with ❤️ for the Arch Linux community
+You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.

arch_ops_server-0.1.3.dist-info/RECORD

@@ -0,0 +1,11 @@
+arch_ops_server/__init__.py,sha256=XPekyNNo3kc3id4udFE_qzdLNkWGF4qePeSTKlRynWE,1953
+arch_ops_server/aur.py,sha256=poYbh2DW7I1tZfCeNp_7e10fh9ZZx8HTnYZnKKZtflQ,49808
+arch_ops_server/pacman.py,sha256=l46iWgwAWl1MVLsfBYrA2xwuE2BCluaVMZPJ1iZzwAA,9909
+arch_ops_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+arch_ops_server/server.py,sha256=Pij1KtsrhEdSlXn-4k9dC6AAywxZQ6D_6fZLy29baqQ,25235
+arch_ops_server/utils.py,sha256=po7MVqCx-hsdx-lOgs7uGicjoUVMf6HvuNNYl2qyFH0,10112
+arch_ops_server/wiki.py,sha256=XB_emMGXYF3Vn5likRICkGOa72YDZvOhtZBgp_d1gg8,7350
+arch_ops_server-0.1.3.dist-info/WHEEL,sha256=DpNsHFUm_gffZe1FgzmqwuqiuPC6Y-uBCzibcJcdupM,78
+arch_ops_server-0.1.3.dist-info/entry_points.txt,sha256=nD6HtiLT-Xh1b63_LGcYNEjHqVlal7I2d5jeFJMtfiU,63
+arch_ops_server-0.1.3.dist-info/METADATA,sha256=pKI-2c6BdaAWxonxi6qhFguWJMzUAiDdnYTpYGOp6S4,5117
+arch_ops_server-0.1.3.dist-info/RECORD,,

{arch_ops_server-0.1.1.dist-info → arch_ops_server-0.1.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.4
+Generator: uv 0.9.8
 Root-Is-Purelib: true
 Tag: py3-none-any

arch_ops_server-0.1.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-arch_ops_server/__init__.py,sha256=m0KiRT4iLqY5eyP3Ul-anwQVdpjTghWWW1QOqk6n1NI,1906
-arch_ops_server/aur.py,sha256=_BoPsKyBPa2KWi9i1J_RSsqUT53wU03guS0V1sasOXg,46328
-arch_ops_server/pacman.py,sha256=nD1B8KgHuwaxHtcO4sd1WpiFcpocjD6yxs1JtVkTjPU,9862
-arch_ops_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-arch_ops_server/server.py,sha256=5KTPOwzREv5_YUOe9AxquLOy48z8y00jgu3u5uWuNDE,25200
-arch_ops_server/utils.py,sha256=-v47tnfxRP-IqvKeqhpAIYVIPhTIh5DMe9jWvCMNRGM,8145
-arch_ops_server/wiki.py,sha256=P6znxzV2e9JVUq8yyD0e9pP0Fm7EkS9vmDb2HUdwQpc,7303
-arch_ops_server-0.1.1.dist-info/WHEEL,sha256=k57ZwB-NkeM_6AsPnuOHv5gI5KM5kPD6Vx85WmGEcI0,78
-arch_ops_server-0.1.1.dist-info/entry_points.txt,sha256=nD6HtiLT-Xh1b63_LGcYNEjHqVlal7I2d5jeFJMtfiU,63
-arch_ops_server-0.1.1.dist-info/METADATA,sha256=1KpPcE2_j0yAaY4J8ToGEV6XK1g8cmr8hLhb4Vxzt_A,4183
-arch_ops_server-0.1.1.dist-info/RECORD,,