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

arch_ops_server-3.0.0/PKG-INFO

@@ -0,0 +1,250 @@
+Metadata-Version: 2.3
+Name: arch-ops-server
+Version: 3.0.0
+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-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
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Archiving :: Packaging
+Classifier: Topic :: System :: Systems Administration
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: markdownify>=0.12.0
+Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0 ; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0 ; extra == 'dev'
+Requires-Dist: httpx>=0.27.0 ; extra == 'dev'
+Requires-Python: >=3.11
+Provides-Extra: dev
+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.
+
+Leverage AI to get  output for digestible, structured results that are ready for follow up questions and actions.
+
+📖 [Complete Documentation with Comfy Guides](https://nxk.mintlify.app/arch-mcp)
+
+## 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:
+
+#### Documentation & Search
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
+
+#### Package Information
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archrepo://` | `archrepo://vim` | Official repository package details |
+| `aur://*/info` | `aur://yay/info` | AUR package metadata (votes, maintainer, dates) |
+| `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
+
+#### System Packages (Arch only)
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `pacman://installed` | `pacman://installed` | System installed packages list |
+| `pacman://orphans` | `pacman://orphans` | Orphaned packages |
+| `pacman://explicit` | `pacman://explicit` | Explicitly installed packages |
+| `pacman://groups` | `pacman://groups` | All package groups |
+| `pacman://group/*` | `pacman://group/base-devel` | Packages in specific group |
+| `pacman://database/freshness` | `pacman://database/freshness` | Package database sync status |
+
+#### System Monitoring & Logs
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `system://info` | `system://info` | System information (kernel, memory, uptime) |
+| `system://disk` | `system://disk` | Disk space usage statistics |
+| `system://services/failed` | `system://services/failed` | Failed systemd services |
+| `system://logs/boot` | `system://logs/boot` | Recent boot logs |
+| `pacman://log/recent` | `pacman://log/recent` | Recent package transactions |
+| `pacman://log/failed` | `pacman://log/failed` | Failed package transactions |
+
+#### News & Updates
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archnews://latest` | `archnews://latest` | Latest Arch Linux news |
+| `archnews://critical` | `archnews://critical` | Critical news requiring manual intervention |
+| `archnews://since-update` | `archnews://since-update` | News since last system update |
+
+#### Configuration
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `config://pacman` | `config://pacman` | Parsed pacman.conf configuration |
+| `config://makepkg` | `config://makepkg` | Parsed makepkg.conf configuration |
+| `mirrors://active` | `mirrors://active` | Currently configured mirrors |
+| `mirrors://health` | `mirrors://health` | Mirror configuration health status |
+
+### Tools (Executable Functions)
+
+#### Package Search & Information
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `search_archwiki` | Query Arch Wiki with ranked results | Any |
+| `search_aur` | Search AUR (relevance/votes/popularity/modified) | Any |
+| `get_official_package_info` | Get official package details (hybrid local/remote) | Any |
+
+#### Package Lifecycle Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `check_updates_dry_run` | Check for available updates | Arch only |
+| `install_package_secure` | Install with security checks (blocks malicious packages) | Arch only |
+| `remove_package` | Remove single package (with deps, forced) | Arch only |
+| `remove_packages_batch` | Remove multiple packages efficiently | Arch only |
+
+#### Package Analysis & Maintenance
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `list_orphan_packages` | Find orphaned packages | Arch only |
+| `remove_orphans` | Clean orphans (dry-run, exclusions) | Arch only |
+| `verify_package_integrity` | Check file integrity (modified/missing files) | Arch only |
+| `list_explicit_packages` | List user-installed packages | Arch only |
+| `mark_as_explicit` | Prevent package from being orphaned | Arch only |
+| `mark_as_dependency` | Allow package to be orphaned | Arch only |
+
+#### Package Organization
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `find_package_owner` | Find which package owns a file | Arch only |
+| `list_package_files` | List files in package (regex filtering) | Arch only |
+| `search_package_files` | Search files across packages | Arch only |
+| `list_package_groups` | List all groups (base, base-devel, etc.) | Arch only |
+| `list_group_packages` | Show packages in specific group | Arch only |
+
+#### System Monitoring & Diagnostics
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_system_info` | System info (kernel, memory, uptime) | Any |
+| `check_disk_space` | Disk usage with warnings | Any |
+| `get_pacman_cache_stats` | Package cache size and age | Arch only |
+| `check_failed_services` | Find failed systemd services | systemd |
+| `get_boot_logs` | Retrieve journalctl boot logs | systemd |
+| `check_database_freshness` | Check package database sync status | Arch only |
+
+#### Transaction History & Logs
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_transaction_history` | Recent package transactions (install/upgrade/remove) | Arch only |
+| `find_when_installed` | Package installation history | Arch only |
+| `find_failed_transactions` | Failed package operations | Arch only |
+| `get_database_sync_history` | Database sync events | Arch only |
+
+#### News & Safety Checks
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_latest_news` | Fetch Arch Linux news from RSS | Any |
+| `check_critical_news` | Find critical news (manual intervention required) | Any |
+| `get_news_since_last_update` | News posted since last system update | Arch only |
+
+#### Mirror Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `list_active_mirrors` | Show configured mirrors | Arch only |
+| `test_mirror_speed` | Test mirror latency | Arch only |
+| `suggest_fastest_mirrors` | Recommend optimal mirrors by location | Any |
+| `check_mirrorlist_health` | Verify mirror configuration | Arch only |
+
+#### Configuration Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `analyze_pacman_conf` | Parse pacman.conf settings | Arch only |
+| `analyze_makepkg_conf` | Parse makepkg.conf settings | Arch only |
+| `check_ignored_packages` | List ignored packages (warns on critical) | Arch only |
+| `get_parallel_downloads_setting` | Get parallel download config | Arch only |
+
+#### Security Analysis
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis (50+ red flags) | Any |
+| `analyze_package_metadata_risk` | Package trust scoring (votes, maintainer, age) | Any |
+
+### Prompts (Guided Workflows)
+
+| Prompt | Purpose | Workflow |
+|--------|---------|----------|
+| `troubleshoot_issue` | Diagnose system errors | Extract keywords → Search Wiki → Context-aware suggestions |
+| `audit_aur_package` | Pre-installation safety audit | Fetch metadata → Analyze PKGBUILD → Security recommendations |
+| `analyze_dependencies` | Installation planning | Check repos → Map dependencies → Suggest install order |
+| `safe_system_update` | Safe update workflow | Check critical news → Verify disk space → List updates → Check services → Recommendations |
+
+---
+
+## Installation
+
+### Prerequisites
+- Python 3.11+
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Quick Install with `uvx`
+
+```bash
+uvx arch-ops-server
+```
+---
+
+## Configuration
+
+Claude / Cursor / Any MCP client that supports STDIO transport
+
+```json
+{
+  "mcpServers": {
+    "arch-ops": {
+      "command": "uvx",
+      "args": ["arch-ops-server"]
+    }
+  }
+}
+```
+
+## Contributing
+
+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)
+
+You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.

arch_ops_server-3.0.0/README.md

@@ -0,0 +1,217 @@
+# 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.
+
+Leverage AI to get  output for digestible, structured results that are ready for follow up questions and actions.
+
+📖 [Complete Documentation with Comfy Guides](https://nxk.mintlify.app/arch-mcp)
+
+## 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:
+
+#### Documentation & Search
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
+
+#### Package Information
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archrepo://` | `archrepo://vim` | Official repository package details |
+| `aur://*/info` | `aur://yay/info` | AUR package metadata (votes, maintainer, dates) |
+| `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
+
+#### System Packages (Arch only)
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `pacman://installed` | `pacman://installed` | System installed packages list |
+| `pacman://orphans` | `pacman://orphans` | Orphaned packages |
+| `pacman://explicit` | `pacman://explicit` | Explicitly installed packages |
+| `pacman://groups` | `pacman://groups` | All package groups |
+| `pacman://group/*` | `pacman://group/base-devel` | Packages in specific group |
+| `pacman://database/freshness` | `pacman://database/freshness` | Package database sync status |
+
+#### System Monitoring & Logs
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `system://info` | `system://info` | System information (kernel, memory, uptime) |
+| `system://disk` | `system://disk` | Disk space usage statistics |
+| `system://services/failed` | `system://services/failed` | Failed systemd services |
+| `system://logs/boot` | `system://logs/boot` | Recent boot logs |
+| `pacman://log/recent` | `pacman://log/recent` | Recent package transactions |
+| `pacman://log/failed` | `pacman://log/failed` | Failed package transactions |
+
+#### News & Updates
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `archnews://latest` | `archnews://latest` | Latest Arch Linux news |
+| `archnews://critical` | `archnews://critical` | Critical news requiring manual intervention |
+| `archnews://since-update` | `archnews://since-update` | News since last system update |
+
+#### Configuration
+| URI Scheme | Example | Returns |
+|------------|---------|---------|
+| `config://pacman` | `config://pacman` | Parsed pacman.conf configuration |
+| `config://makepkg` | `config://makepkg` | Parsed makepkg.conf configuration |
+| `mirrors://active` | `mirrors://active` | Currently configured mirrors |
+| `mirrors://health` | `mirrors://health` | Mirror configuration health status |
+
+### Tools (Executable Functions)
+
+#### Package Search & Information
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `search_archwiki` | Query Arch Wiki with ranked results | Any |
+| `search_aur` | Search AUR (relevance/votes/popularity/modified) | Any |
+| `get_official_package_info` | Get official package details (hybrid local/remote) | Any |
+
+#### Package Lifecycle Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `check_updates_dry_run` | Check for available updates | Arch only |
+| `install_package_secure` | Install with security checks (blocks malicious packages) | Arch only |
+| `remove_package` | Remove single package (with deps, forced) | Arch only |
+| `remove_packages_batch` | Remove multiple packages efficiently | Arch only |
+
+#### Package Analysis & Maintenance
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `list_orphan_packages` | Find orphaned packages | Arch only |
+| `remove_orphans` | Clean orphans (dry-run, exclusions) | Arch only |
+| `verify_package_integrity` | Check file integrity (modified/missing files) | Arch only |
+| `list_explicit_packages` | List user-installed packages | Arch only |
+| `mark_as_explicit` | Prevent package from being orphaned | Arch only |
+| `mark_as_dependency` | Allow package to be orphaned | Arch only |
+
+#### Package Organization
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `find_package_owner` | Find which package owns a file | Arch only |
+| `list_package_files` | List files in package (regex filtering) | Arch only |
+| `search_package_files` | Search files across packages | Arch only |
+| `list_package_groups` | List all groups (base, base-devel, etc.) | Arch only |
+| `list_group_packages` | Show packages in specific group | Arch only |
+
+#### System Monitoring & Diagnostics
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_system_info` | System info (kernel, memory, uptime) | Any |
+| `check_disk_space` | Disk usage with warnings | Any |
+| `get_pacman_cache_stats` | Package cache size and age | Arch only |
+| `check_failed_services` | Find failed systemd services | systemd |
+| `get_boot_logs` | Retrieve journalctl boot logs | systemd |
+| `check_database_freshness` | Check package database sync status | Arch only |
+
+#### Transaction History & Logs
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_transaction_history` | Recent package transactions (install/upgrade/remove) | Arch only |
+| `find_when_installed` | Package installation history | Arch only |
+| `find_failed_transactions` | Failed package operations | Arch only |
+| `get_database_sync_history` | Database sync events | Arch only |
+
+#### News & Safety Checks
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `get_latest_news` | Fetch Arch Linux news from RSS | Any |
+| `check_critical_news` | Find critical news (manual intervention required) | Any |
+| `get_news_since_last_update` | News posted since last system update | Arch only |
+
+#### Mirror Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `list_active_mirrors` | Show configured mirrors | Arch only |
+| `test_mirror_speed` | Test mirror latency | Arch only |
+| `suggest_fastest_mirrors` | Recommend optimal mirrors by location | Any |
+| `check_mirrorlist_health` | Verify mirror configuration | Arch only |
+
+#### Configuration Management
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `analyze_pacman_conf` | Parse pacman.conf settings | Arch only |
+| `analyze_makepkg_conf` | Parse makepkg.conf settings | Arch only |
+| `check_ignored_packages` | List ignored packages (warns on critical) | Arch only |
+| `get_parallel_downloads_setting` | Get parallel download config | Arch only |
+
+#### Security Analysis
+| Tool | Description | Platform |
+|------|-------------|----------|
+| `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis (50+ red flags) | Any |
+| `analyze_package_metadata_risk` | Package trust scoring (votes, maintainer, age) | Any |
+
+### Prompts (Guided Workflows)
+
+| Prompt | Purpose | Workflow |
+|--------|---------|----------|
+| `troubleshoot_issue` | Diagnose system errors | Extract keywords → Search Wiki → Context-aware suggestions |
+| `audit_aur_package` | Pre-installation safety audit | Fetch metadata → Analyze PKGBUILD → Security recommendations |
+| `analyze_dependencies` | Installation planning | Check repos → Map dependencies → Suggest install order |
+| `safe_system_update` | Safe update workflow | Check critical news → Verify disk space → List updates → Check services → Recommendations |
+
+---
+
+## Installation
+
+### Prerequisites
+- Python 3.11+
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Quick Install with `uvx`
+
+```bash
+uvx arch-ops-server
+```
+---
+
+## Configuration
+
+Claude / Cursor / Any MCP client that supports STDIO transport
+
+```json
+{
+  "mcpServers": {
+    "arch-ops": {
+      "command": "uvx",
+      "args": ["arch-ops-server"]
+    }
+  }
+}
+```
+
+## Contributing
+
+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)
+
+You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.

{arch_ops_server-0.1.3 → arch_ops_server-3.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arch-ops-server"
-version = "0.1.3"
+version = "3.0.0"
 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-only OR MIT" }
@@ -33,6 +33,44 @@ dependencies = [
 [project.scripts]
 arch-ops-server = "arch_ops_server:main_sync"
 
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+    "pytest-mock>=3.12.0",
+    "httpx>=0.27.0",  # For testing async HTTP
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+addopts = [
+    "-v",
+    "--strict-markers",
+    "--cov=arch_ops_server",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+
+[tool.coverage.run]
+source = ["arch_ops_server"]
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]
+
 [build-system]
 requires = ["uv_build>=0.9.4,<0.10.0"]
 build-backend = "uv_build"

arch_ops_server-3.0.0/src/arch_ops_server/__init__.py

@@ -0,0 +1,166 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
+"""
+Arch Linux MCP Server
+
+A Model Context Protocol server that bridges AI assistants with the Arch Linux
+ecosystem, providing access to the Arch Wiki, AUR, and official repositories.
+"""
+
+__version__ = "0.1.0"
+
+from .wiki import search_wiki, get_wiki_page, get_wiki_page_as_text
+from .aur import (
+    search_aur, 
+    get_aur_info, 
+    get_pkgbuild, 
+    get_aur_file, 
+    analyze_pkgbuild_safety, 
+    analyze_package_metadata_risk,
+    install_package_secure
+)
+from .pacman import (
+    get_official_package_info,
+    check_updates_dry_run,
+    remove_package,
+    remove_packages_batch,
+    list_orphan_packages,
+    remove_orphans,
+    find_package_owner,
+    list_package_files,
+    search_package_files,
+    verify_package_integrity,
+    list_package_groups,
+    list_group_packages,
+    list_explicit_packages,
+    mark_as_explicit,
+    mark_as_dependency,
+    check_database_freshness
+)
+from .system import (
+    get_system_info,
+    check_disk_space,
+    get_pacman_cache_stats,
+    check_failed_services,
+    get_boot_logs
+)
+from .news import (
+    get_latest_news,
+    check_critical_news,
+    get_news_since_last_update
+)
+from .logs import (
+    get_transaction_history,
+    find_when_installed,
+    find_failed_transactions,
+    get_database_sync_history
+)
+from .mirrors import (
+    list_active_mirrors,
+    test_mirror_speed,
+    suggest_fastest_mirrors,
+    check_mirrorlist_health
+)
+from .config import (
+    analyze_pacman_conf,
+    analyze_makepkg_conf,
+    check_ignored_packages,
+    get_parallel_downloads_setting
+)
+from .utils import IS_ARCH, run_command
+
+# Import server from the server module
+from .server import server
+
+# Main function will be defined here
+async def main():
+    """
+    Main entry point for the MCP server.
+    Runs the server using STDIO transport.
+    """
+    import asyncio
+    import mcp.server.stdio
+    import logging
+    
+    # Set up logging
+    logging.basicConfig(level=logging.INFO)
+    logger = logging.getLogger(__name__)
+    
+    logger.info("Starting Arch Linux MCP Server")
+    logger.info(f"Running on Arch Linux: {IS_ARCH}")
+    
+    # Run the server using STDIO
+    async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            server.create_initialization_options()
+        )
+
+
+def main_sync():
+    """Synchronous wrapper for the main function."""
+    import asyncio
+    asyncio.run(main())
+
+__all__ = [
+    # Wiki
+    "search_wiki",
+    "get_wiki_page",
+    "get_wiki_page_as_text",
+    # AUR
+    "search_aur",
+    "get_aur_info",
+    "get_pkgbuild",
+    "get_aur_file",
+    "analyze_pkgbuild_safety",
+    "analyze_package_metadata_risk",
+    "install_package_secure",
+    # Pacman
+    "get_official_package_info",
+    "check_updates_dry_run",
+    "remove_package",
+    "remove_packages_batch",
+    "list_orphan_packages",
+    "remove_orphans",
+    "find_package_owner",
+    "list_package_files",
+    "search_package_files",
+    "verify_package_integrity",
+    "list_package_groups",
+    "list_group_packages",
+    "list_explicit_packages",
+    "mark_as_explicit",
+    "mark_as_dependency",
+    "check_database_freshness",
+    # System
+    "get_system_info",
+    "check_disk_space",
+    "get_pacman_cache_stats",
+    "check_failed_services",
+    "get_boot_logs",
+    # News
+    "get_latest_news",
+    "check_critical_news",
+    "get_news_since_last_update",
+    # Logs
+    "get_transaction_history",
+    "find_when_installed",
+    "find_failed_transactions",
+    "get_database_sync_history",
+    # Mirrors
+    "list_active_mirrors",
+    "test_mirror_speed",
+    "suggest_fastest_mirrors",
+    "check_mirrorlist_health",
+    # Config
+    "analyze_pacman_conf",
+    "analyze_makepkg_conf",
+    "check_ignored_packages",
+    "get_parallel_downloads_setting",
+    # Utils
+    "IS_ARCH",
+    "run_command",
+    # Main functions
+    "main",
+    "main_sync",
+]