arch-ops-server 0.1.1__tar.gz → 0.1.3__tar.gz

{arch_ops_server-0.1.1 → arch_ops_server-0.1.3}/PKG-INFO

@@ -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.1 → arch_ops_server-0.1.3}/README.md

@@ -1,5 +1,9 @@
 # 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.
@@ -10,6 +14,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:
@@ -55,7 +73,6 @@ Direct access to Arch ecosystem data via custom URI schemes:
 ```bash
 uvx arch-ops-server
 ```
-
 ---
 
 ## Configuration
@@ -73,11 +90,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.1 → arch_ops_server-0.1.3}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "arch-ops-server"
-version = "0.1.1"
+version = "0.1.3"
 description = "MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)"
 readme = {file = "README.md", content-type = "text/markdown"}
-license = { text = "GPL-3.0" }
+license = { text = "GPL-3.0-only OR MIT" }
 authors = [
     { name = "Nihal", email = "2tv8xupqg@mozmail.com" }
 ]
@@ -13,6 +13,7 @@ classifiers = [
     "Intended Audience :: Developers",
     "Intended Audience :: System Administrators",
     "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+    "License :: OSI Approved :: MIT License",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",

{arch_ops_server-0.1.1 → arch_ops_server-0.1.3}/src/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-0.1.1 → arch_ops_server-0.1.3}/src/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-0.1.1 → arch_ops_server-0.1.3}/src/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-0.1.1 → arch_ops_server-0.1.3}/src/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-0.1.1 → arch_ops_server-0.1.3}/src/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-0.1.1 → arch_ops_server-0.1.3}/src/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.