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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,133 +0,0 @@
1
- Metadata-Version: 2.3
2
- Name: arch-ops-server
3
- Version: 0.1.3
4
- Summary: MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)
5
- Keywords: arch-linux,mcp,model-context-protocol,aur,pacman,wiki,ai-assistant
6
- Author: Nihal
7
- Author-email: Nihal <2tv8xupqg@mozmail.com>
8
- License: GPL-3.0-only OR MIT
9
- Classifier: Development Status :: 4 - Beta
10
- Classifier: Intended Audience :: Developers
11
- Classifier: Intended Audience :: System Administrators
12
- Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
13
- Classifier: License :: OSI Approved :: MIT License
14
- Classifier: Operating System :: POSIX :: Linux
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3.11
17
- Classifier: Programming Language :: Python :: 3.12
18
- Classifier: Topic :: System :: Archiving :: Packaging
19
- Classifier: Topic :: System :: Systems Administration
20
- Requires-Dist: mcp>=1.0.0
21
- Requires-Dist: httpx>=0.27.0
22
- Requires-Dist: beautifulsoup4>=4.12.0
23
- Requires-Dist: lxml>=5.0.0
24
- Requires-Dist: markdownify>=0.12.0
25
- Requires-Python: >=3.11
26
- Description-Content-Type: text/markdown
27
-
28
- # Arch Linux MCP Server
29
-
30
- <a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp">
31
- <img width="380" height="200" src="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp/badge" />
32
- </a>
33
-
34
- **Disclaimer:** Unofficial community project, not affiliated with Arch Linux.
35
-
36
- 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.
37
-
38
- Leverage AI to get output for digestible, structured results that are ready for follow up questions and actions.
39
-
40
- 📖 [Complete Documentation with Comfy Guides](https://nxk.mintlify.app/arch-mcp)
41
-
42
- ## Sneak Peak into what's available
43
-
44
- <details open>
45
- <summary>Claude Desktop (no terminal)</summary>
46
-
47
- ![Claude Desktop Demo](assets/claudedesktop_signalcli.gif)
48
-
49
- </details>
50
-
51
- <details>
52
- <summary>VS Code (with terminal)</summary>
53
-
54
- ![VS Code Demo](assets/vscode_notesnook.gif)
55
-
56
- </details>
57
-
58
- ### Resources (URI-based Access)
59
-
60
- Direct access to Arch ecosystem data via custom URI schemes:
61
-
62
- | URI Scheme | Example | Returns |
63
- |------------|---------|---------|
64
- | `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
65
- | `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
66
- | `aur://*/info` | `aur://yay/info` | AUR package metadata (votes, maintainer, dates) |
67
- | `archrepo://` | `archrepo://vim` | Official repository package details |
68
- | `pacman://installed` | `pacman://installed` | System installed packages list (Arch only) |
69
-
70
- ### Tools (Executable Functions)
71
-
72
- | Category | Tool | Description | Key Features |
73
- |----------|------|-------------|--------------|
74
- | **Search** | `search_archwiki` | Query Arch Wiki documentation | Ranked results, keyword extraction |
75
- | | `search_aur` | Search AUR packages | Smart ranking: relevance/votes/popularity/modified |
76
- | | `get_official_package_info` | Lookup official packages | Hybrid local/remote, detailed metadata |
77
- | **System** | `check_updates_dry_run` | Check for updates (Arch only) | Read-only, safe, requires pacman-contrib |
78
- | **Installation** | `install_package_secure` | Secure package installation | Auto security checks, blocks malicious packages, uses paru/yay |
79
- | **Security** | `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis | Detects: malicious commands based on 50+ red flags |
80
- | | `analyze_package_metadata_risk` | Package trust evaluation | Analyzes: votes, maintainer, age, updates, trust scoring |
81
-
82
- ### Prompts (Guided Workflows)
83
-
84
- | Prompt | Purpose | Workflow |
85
- |--------|---------|----------|
86
- | `troubleshoot_issue` | Diagnose system errors | Extract keywords → Search Wiki → Context-aware suggestions |
87
- | `audit_aur_package` | Pre-installation safety audit | Fetch metadata → Analyze PKGBUILD → Security recommendations |
88
- | `analyze_dependencies` | Installation planning | Check repos → Map dependencies → Suggest install order |
89
-
90
- ---
91
-
92
- ## Installation
93
-
94
- ### Prerequisites
95
- - Python 3.11+
96
- - [uv](https://github.com/astral-sh/uv) (recommended) or pip
97
-
98
- ### Quick Install with `uvx`
99
-
100
- ```bash
101
- uvx arch-ops-server
102
- ```
103
- ---
104
-
105
- ## Configuration
106
-
107
- Claude / Cursor / Any MCP client that supports STDIO transport
108
-
109
- ```json
110
- {
111
- "mcpServers": {
112
- "arch-ops": {
113
- "command": "uvx",
114
- "args": ["arch-ops-server"]
115
- }
116
- }
117
- }
118
- ```
119
-
120
- ## Contributing
121
-
122
- Contributions are greatly appreciated. Please feel free to submit a pull request or open an issue and help make things better for everyone.
123
-
124
- [Contributing Guide](https://nxk.mintlify.app/arch-mcp/contributing)
125
-
126
- ## License
127
-
128
- This project is dual-licensed under your choice of:
129
-
130
- - **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - See [LICENSE-GPL](LICENSE-GPL)
131
- - **[MIT License](https://opensource.org/licenses/MIT)** - See [LICENSE-MIT](LICENSE-MIT)
132
-
133
- You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.
@@ -1,11 +0,0 @@
1
- arch_ops_server/__init__.py,sha256=XPekyNNo3kc3id4udFE_qzdLNkWGF4qePeSTKlRynWE,1953
2
- arch_ops_server/aur.py,sha256=poYbh2DW7I1tZfCeNp_7e10fh9ZZx8HTnYZnKKZtflQ,49808
3
- arch_ops_server/pacman.py,sha256=l46iWgwAWl1MVLsfBYrA2xwuE2BCluaVMZPJ1iZzwAA,9909
4
- arch_ops_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
5
- arch_ops_server/server.py,sha256=Pij1KtsrhEdSlXn-4k9dC6AAywxZQ6D_6fZLy29baqQ,25235
6
- arch_ops_server/utils.py,sha256=po7MVqCx-hsdx-lOgs7uGicjoUVMf6HvuNNYl2qyFH0,10112
7
- arch_ops_server/wiki.py,sha256=XB_emMGXYF3Vn5likRICkGOa72YDZvOhtZBgp_d1gg8,7350
8
- arch_ops_server-0.1.3.dist-info/WHEEL,sha256=DpNsHFUm_gffZe1FgzmqwuqiuPC6Y-uBCzibcJcdupM,78
9
- arch_ops_server-0.1.3.dist-info/entry_points.txt,sha256=nD6HtiLT-Xh1b63_LGcYNEjHqVlal7I2d5jeFJMtfiU,63
10
- arch_ops_server-0.1.3.dist-info/METADATA,sha256=pKI-2c6BdaAWxonxi6qhFguWJMzUAiDdnYTpYGOp6S4,5117
11
- arch_ops_server-0.1.3.dist-info/RECORD,,