arch-ops-server 3.0.1__tar.gz → 3.2.0__tar.gz

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,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: arch-ops-server
3
- Version: 3.0.1
3
+ Version: 3.2.0
4
4
  Summary: MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)
5
5
  Keywords: arch-linux,mcp,model-context-protocol,aur,pacman,wiki,ai-assistant
6
6
  Author: Nihal
@@ -36,6 +36,8 @@ Description-Content-Type: text/markdown
36
36
 
37
37
  # Arch Linux MCP Server
38
38
 
39
+ [![PyPI Downloads](https://static.pepy.tech/personalized-badge/arch-ops-server?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLUE&right_color=BLACK&left_text=PyPi+Downloads)](https://pepy.tech/projects/arch-ops-server)
40
+
39
41
  <a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp">
40
42
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp/badge" />
41
43
  </a>
@@ -50,17 +52,18 @@ Leverage AI to get output for digestible, structured results that are ready for
50
52
 
51
53
  ## Sneak Peak into what's available
52
54
 
53
- <details open>
54
- <summary>Claude Desktop (no terminal)</summary>
55
+ <details>
56
+
57
+ <summary>Using VS Code Sonnet 3.5 for Safe Installation from AUR</summary>
55
58
 
56
- ![Claude Desktop Demo](assets/claudedesktop_signalcli.gif)
59
+ ![VS Code Demo](assets/vscode_notesnook.gif)
57
60
 
58
61
  </details>
59
62
 
60
63
  <details>
61
- <summary>VS Code (with terminal)</summary>
64
+ <summary> Asking Claude Code Sonnet 4.5 for fedora equivalent command </summary>
62
65
 
63
- ![VS Code Demo](assets/vscode_notesnook.gif)
66
+ ![Equivalent Command Demo](assets/equivalent-commands.gif)
64
67
 
65
68
  </details>
66
69
 
@@ -69,11 +72,13 @@ Leverage AI to get output for digestible, structured results that are ready for
69
72
  Direct access to Arch ecosystem data via custom URI schemes:
70
73
 
71
74
  #### Documentation & Search
75
+
72
76
  | URI Scheme | Example | Returns |
73
77
  |------------|---------|---------|
74
78
  | `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
75
79
 
76
80
  #### Package Information
81
+
77
82
  | URI Scheme | Example | Returns |
78
83
  |------------|---------|---------|
79
84
  | `archrepo://` | `archrepo://vim` | Official repository package details |
@@ -81,6 +86,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
81
86
  | `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
82
87
 
83
88
  #### System Packages (Arch only)
89
+
84
90
  | URI Scheme | Example | Returns |
85
91
  |------------|---------|---------|
86
92
  | `pacman://installed` | `pacman://installed` | System installed packages list |
@@ -91,6 +97,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
91
97
  | `pacman://database/freshness` | `pacman://database/freshness` | Package database sync status |
92
98
 
93
99
  #### System Monitoring & Logs
100
+
94
101
  | URI Scheme | Example | Returns |
95
102
  |------------|---------|---------|
96
103
  | `system://info` | `system://info` | System information (kernel, memory, uptime) |
@@ -101,6 +108,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
101
108
  | `pacman://log/failed` | `pacman://log/failed` | Failed package transactions |
102
109
 
103
110
  #### News & Updates
111
+
104
112
  | URI Scheme | Example | Returns |
105
113
  |------------|---------|---------|
106
114
  | `archnews://latest` | `archnews://latest` | Latest Arch Linux news |
@@ -108,6 +116,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
108
116
  | `archnews://since-update` | `archnews://since-update` | News since last system update |
109
117
 
110
118
  #### Configuration
119
+
111
120
  | URI Scheme | Example | Returns |
112
121
  |------------|---------|---------|
113
122
  | `config://pacman` | `config://pacman` | Parsed pacman.conf configuration |
@@ -118,6 +127,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
118
127
  ### Tools (Executable Functions)
119
128
 
120
129
  #### Package Search & Information
130
+
121
131
  | Tool | Description | Platform |
122
132
  |------|-------------|----------|
123
133
  | `search_archwiki` | Query Arch Wiki with ranked results | Any |
@@ -125,6 +135,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
125
135
  | `get_official_package_info` | Get official package details (hybrid local/remote) | Any |
126
136
 
127
137
  #### Package Lifecycle Management
138
+
128
139
  | Tool | Description | Platform |
129
140
  |------|-------------|----------|
130
141
  | `check_updates_dry_run` | Check for available updates | Arch only |
@@ -133,6 +144,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
133
144
  | `remove_packages_batch` | Remove multiple packages efficiently | Arch only |
134
145
 
135
146
  #### Package Analysis & Maintenance
147
+
136
148
  | Tool | Description | Platform |
137
149
  |------|-------------|----------|
138
150
  | `list_orphan_packages` | Find orphaned packages | Arch only |
@@ -143,6 +155,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
143
155
  | `mark_as_dependency` | Allow package to be orphaned | Arch only |
144
156
 
145
157
  #### Package Organization
158
+
146
159
  | Tool | Description | Platform |
147
160
  |------|-------------|----------|
148
161
  | `find_package_owner` | Find which package owns a file | Arch only |
@@ -152,6 +165,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
152
165
  | `list_group_packages` | Show packages in specific group | Arch only |
153
166
 
154
167
  #### System Monitoring & Diagnostics
168
+
155
169
  | Tool | Description | Platform |
156
170
  |------|-------------|----------|
157
171
  | `get_system_info` | System info (kernel, memory, uptime) | Any |
@@ -162,6 +176,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
162
176
  | `check_database_freshness` | Check package database sync status | Arch only |
163
177
 
164
178
  #### Transaction History & Logs
179
+
165
180
  | Tool | Description | Platform |
166
181
  |------|-------------|----------|
167
182
  | `get_transaction_history` | Recent package transactions (install/upgrade/remove) | Arch only |
@@ -170,6 +185,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
170
185
  | `get_database_sync_history` | Database sync events | Arch only |
171
186
 
172
187
  #### News & Safety Checks
188
+
173
189
  | Tool | Description | Platform |
174
190
  |------|-------------|----------|
175
191
  | `get_latest_news` | Fetch Arch Linux news from RSS | Any |
@@ -177,6 +193,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
177
193
  | `get_news_since_last_update` | News posted since last system update | Arch only |
178
194
 
179
195
  #### Mirror Management
196
+
180
197
  | Tool | Description | Platform |
181
198
  |------|-------------|----------|
182
199
  | `list_active_mirrors` | Show configured mirrors | Arch only |
@@ -185,6 +202,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
185
202
  | `check_mirrorlist_health` | Verify mirror configuration | Arch only |
186
203
 
187
204
  #### Configuration Management
205
+
188
206
  | Tool | Description | Platform |
189
207
  |------|-------------|----------|
190
208
  | `analyze_pacman_conf` | Parse pacman.conf settings | Arch only |
@@ -193,6 +211,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
193
211
  | `get_parallel_downloads_setting` | Get parallel download config | Arch only |
194
212
 
195
213
  #### Security Analysis
214
+
196
215
  | Tool | Description | Platform |
197
216
  |------|-------------|----------|
198
217
  | `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis (50+ red flags) | Any |
@@ -212,6 +231,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
212
231
  ## Installation
213
232
 
214
233
  ### Prerequisites
234
+
215
235
  - Python 3.11+
216
236
  - [uv](https://github.com/astral-sh/uv) (recommended) or pip
217
237
 
@@ -220,6 +240,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
220
240
  ```bash
221
241
  uvx arch-ops-server
222
242
  ```
243
+
223
244
  ---
224
245
 
225
246
  ## Configuration
@@ -247,7 +268,10 @@ Contributions are greatly appreciated. Please feel free to submit a pull request
247
268
 
248
269
  This project is dual-licensed under your choice of:
249
270
 
250
- - **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - See [LICENSE-GPL](LICENSE-GPL)
251
- - **[MIT License](https://opensource.org/licenses/MIT)** - See [LICENSE-MIT](LICENSE-MIT)
271
+ - **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - For those who prefer strong copyleft protections. See [LICENSE-GPL](LICENSE-GPL)
272
+ - **[MIT License](https://opensource.org/licenses/MIT)** - For broader compatibility and adoption, including use in proprietary software and compatibility with platforms like Docker MCP Catalog. See [LICENSE-MIT](LICENSE-MIT)
273
+
274
+ You may use this software under the terms of either license. When redistributing or modifying this software, you may choose which license to apply.
275
+
276
+ By contributing to this project, you agree that your contributions will be licensed under both licenses.
252
277
 
253
- You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.
@@ -1,5 +1,7 @@
1
1
  # Arch Linux MCP Server
2
2
 
3
+ [![PyPI Downloads](https://static.pepy.tech/personalized-badge/arch-ops-server?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLUE&right_color=BLACK&left_text=PyPi+Downloads)](https://pepy.tech/projects/arch-ops-server)
4
+
3
5
  <a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp">
4
6
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp/badge" />
5
7
  </a>
@@ -14,17 +16,18 @@ Leverage AI to get output for digestible, structured results that are ready for
14
16
 
15
17
  ## Sneak Peak into what's available
16
18
 
17
- <details open>
18
- <summary>Claude Desktop (no terminal)</summary>
19
+ <details>
20
+
21
+ <summary>Using VS Code Sonnet 3.5 for Safe Installation from AUR</summary>
19
22
 
20
- ![Claude Desktop Demo](assets/claudedesktop_signalcli.gif)
23
+ ![VS Code Demo](assets/vscode_notesnook.gif)
21
24
 
22
25
  </details>
23
26
 
24
27
  <details>
25
- <summary>VS Code (with terminal)</summary>
28
+ <summary> Asking Claude Code Sonnet 4.5 for fedora equivalent command </summary>
26
29
 
27
- ![VS Code Demo](assets/vscode_notesnook.gif)
30
+ ![Equivalent Command Demo](assets/equivalent-commands.gif)
28
31
 
29
32
  </details>
30
33
 
@@ -33,11 +36,13 @@ Leverage AI to get output for digestible, structured results that are ready for
33
36
  Direct access to Arch ecosystem data via custom URI schemes:
34
37
 
35
38
  #### Documentation & Search
39
+
36
40
  | URI Scheme | Example | Returns |
37
41
  |------------|---------|---------|
38
42
  | `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
39
43
 
40
44
  #### Package Information
45
+
41
46
  | URI Scheme | Example | Returns |
42
47
  |------------|---------|---------|
43
48
  | `archrepo://` | `archrepo://vim` | Official repository package details |
@@ -45,6 +50,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
45
50
  | `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
46
51
 
47
52
  #### System Packages (Arch only)
53
+
48
54
  | URI Scheme | Example | Returns |
49
55
  |------------|---------|---------|
50
56
  | `pacman://installed` | `pacman://installed` | System installed packages list |
@@ -55,6 +61,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
55
61
  | `pacman://database/freshness` | `pacman://database/freshness` | Package database sync status |
56
62
 
57
63
  #### System Monitoring & Logs
64
+
58
65
  | URI Scheme | Example | Returns |
59
66
  |------------|---------|---------|
60
67
  | `system://info` | `system://info` | System information (kernel, memory, uptime) |
@@ -65,6 +72,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
65
72
  | `pacman://log/failed` | `pacman://log/failed` | Failed package transactions |
66
73
 
67
74
  #### News & Updates
75
+
68
76
  | URI Scheme | Example | Returns |
69
77
  |------------|---------|---------|
70
78
  | `archnews://latest` | `archnews://latest` | Latest Arch Linux news |
@@ -72,6 +80,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
72
80
  | `archnews://since-update` | `archnews://since-update` | News since last system update |
73
81
 
74
82
  #### Configuration
83
+
75
84
  | URI Scheme | Example | Returns |
76
85
  |------------|---------|---------|
77
86
  | `config://pacman` | `config://pacman` | Parsed pacman.conf configuration |
@@ -82,6 +91,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
82
91
  ### Tools (Executable Functions)
83
92
 
84
93
  #### Package Search & Information
94
+
85
95
  | Tool | Description | Platform |
86
96
  |------|-------------|----------|
87
97
  | `search_archwiki` | Query Arch Wiki with ranked results | Any |
@@ -89,6 +99,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
89
99
  | `get_official_package_info` | Get official package details (hybrid local/remote) | Any |
90
100
 
91
101
  #### Package Lifecycle Management
102
+
92
103
  | Tool | Description | Platform |
93
104
  |------|-------------|----------|
94
105
  | `check_updates_dry_run` | Check for available updates | Arch only |
@@ -97,6 +108,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
97
108
  | `remove_packages_batch` | Remove multiple packages efficiently | Arch only |
98
109
 
99
110
  #### Package Analysis & Maintenance
111
+
100
112
  | Tool | Description | Platform |
101
113
  |------|-------------|----------|
102
114
  | `list_orphan_packages` | Find orphaned packages | Arch only |
@@ -107,6 +119,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
107
119
  | `mark_as_dependency` | Allow package to be orphaned | Arch only |
108
120
 
109
121
  #### Package Organization
122
+
110
123
  | Tool | Description | Platform |
111
124
  |------|-------------|----------|
112
125
  | `find_package_owner` | Find which package owns a file | Arch only |
@@ -116,6 +129,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
116
129
  | `list_group_packages` | Show packages in specific group | Arch only |
117
130
 
118
131
  #### System Monitoring & Diagnostics
132
+
119
133
  | Tool | Description | Platform |
120
134
  |------|-------------|----------|
121
135
  | `get_system_info` | System info (kernel, memory, uptime) | Any |
@@ -126,6 +140,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
126
140
  | `check_database_freshness` | Check package database sync status | Arch only |
127
141
 
128
142
  #### Transaction History & Logs
143
+
129
144
  | Tool | Description | Platform |
130
145
  |------|-------------|----------|
131
146
  | `get_transaction_history` | Recent package transactions (install/upgrade/remove) | Arch only |
@@ -134,6 +149,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
134
149
  | `get_database_sync_history` | Database sync events | Arch only |
135
150
 
136
151
  #### News & Safety Checks
152
+
137
153
  | Tool | Description | Platform |
138
154
  |------|-------------|----------|
139
155
  | `get_latest_news` | Fetch Arch Linux news from RSS | Any |
@@ -141,6 +157,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
141
157
  | `get_news_since_last_update` | News posted since last system update | Arch only |
142
158
 
143
159
  #### Mirror Management
160
+
144
161
  | Tool | Description | Platform |
145
162
  |------|-------------|----------|
146
163
  | `list_active_mirrors` | Show configured mirrors | Arch only |
@@ -149,6 +166,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
149
166
  | `check_mirrorlist_health` | Verify mirror configuration | Arch only |
150
167
 
151
168
  #### Configuration Management
169
+
152
170
  | Tool | Description | Platform |
153
171
  |------|-------------|----------|
154
172
  | `analyze_pacman_conf` | Parse pacman.conf settings | Arch only |
@@ -157,6 +175,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
157
175
  | `get_parallel_downloads_setting` | Get parallel download config | Arch only |
158
176
 
159
177
  #### Security Analysis
178
+
160
179
  | Tool | Description | Platform |
161
180
  |------|-------------|----------|
162
181
  | `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis (50+ red flags) | Any |
@@ -176,6 +195,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
176
195
  ## Installation
177
196
 
178
197
  ### Prerequisites
198
+
179
199
  - Python 3.11+
180
200
  - [uv](https://github.com/astral-sh/uv) (recommended) or pip
181
201
 
@@ -184,6 +204,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
184
204
  ```bash
185
205
  uvx arch-ops-server
186
206
  ```
207
+
187
208
  ---
188
209
 
189
210
  ## Configuration
@@ -211,7 +232,10 @@ Contributions are greatly appreciated. Please feel free to submit a pull request
211
232
 
212
233
  This project is dual-licensed under your choice of:
213
234
 
214
- - **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - See [LICENSE-GPL](LICENSE-GPL)
215
- - **[MIT License](https://opensource.org/licenses/MIT)** - See [LICENSE-MIT](LICENSE-MIT)
235
+ - **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - For those who prefer strong copyleft protections. See [LICENSE-GPL](LICENSE-GPL)
236
+ - **[MIT License](https://opensource.org/licenses/MIT)** - For broader compatibility and adoption, including use in proprietary software and compatibility with platforms like Docker MCP Catalog. See [LICENSE-MIT](LICENSE-MIT)
237
+
238
+ You may use this software under the terms of either license. When redistributing or modifying this software, you may choose which license to apply.
239
+
240
+ By contributing to this project, you agree that your contributions will be licensed under both licenses.
216
241
 
217
- You may use this software under the terms of either license. See [LICENSE](LICENSE) for more details.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "arch-ops-server"
3
- version = "3.0.1"
3
+ version = "3.2.0"
4
4
  description = "MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)"
5
5
  readme = {file = "README.md", content-type = "text/markdown"}
6
6
  license = { text = "GPL-3.0-only OR MIT" }
@@ -6,7 +6,7 @@ A Model Context Protocol server that bridges AI assistants with the Arch Linux
6
6
  ecosystem, providing access to the Arch Wiki, AUR, and official repositories.
7
7
  """
8
8
 
9
- __version__ = "3.0.1"
9
+ __version__ = "3.2.0"
10
10
 
11
11
  from .wiki import search_wiki, get_wiki_page, get_wiki_page_as_text
12
12
  from .aur import (
@@ -43,6 +43,7 @@ from .system import (
43
43
  check_failed_services,
44
44
  get_boot_logs
45
45
  )
46
+ from .system_health_check import run_system_health_check
46
47
  from .news import (
47
48
  get_latest_news,
48
49
  check_critical_news,
@@ -147,6 +148,7 @@ __all__ = [
147
148
  "get_pacman_cache_stats",
148
149
  "check_failed_services",
149
150
  "get_boot_logs",
151
+ "run_system_health_check",
150
152
  # News
151
153
  "get_latest_news",
152
154
  "check_critical_news",