Package Version MCP Server

1# Package Version MCP Server
2 
3[![smithery badge](https://smithery.ai/badge/mcp-package-version)](https://smithery.ai/server/mcp-package-version)
4 
5An MCP server that provides tools for checking latest stable package versions from multiple package registries:
6 
7- npm (Node.js/JavaScript)
8- PyPI (Python)
9- Maven Central (Java)
10- Go Proxy (Go)
11- Swift Packages (Swift)
12- AWS Bedrock (AI Models)
13- Docker Hub (Container Images)
14- GitHub Container Registry (Container Images)
15- GitHub Actions
16 
17This server helps LLMs ensure they're recommending up-to-date package versions when writing code.
18 
19**IMPORTANT: I'm slowly moving across this tool to a component of my [mcp-devtools](https://github.com/sammcj/mcp-devtools) server**
20 
21<a href="https://glama.ai/mcp/servers/zkts2w92ba"><img width="380" height="200" src="https://glama.ai/mcp/servers/zkts2w92ba/badge" alt="https://github.com/sammcj/mcp-package-version MCP server" /></a>
22 
23## Screenshot
24 
25![tooling with and without mcp-package-version](images/with-without.jpg)
26 
27- [Package Version MCP Server](#package-version-mcp-server)
28  - [Screenshot](#screenshot)
29  - [Installation](#installation)
30  - [Usage](#usage)
31  - [Tools](#tools)
32  - [Releases and CI/CD](#releases-and-cicd)
33  - [License](#license)
34 
35## Installation
36 
37Requirements:
38 
39- A modern go version installed (See [Go Installation](https://go.dev/doc/install))
40 
41Using `go install` (Recommended for MCP Client Setup):
42 
43```bash
44go install github.com/sammcj/mcp-package-version/v2@HEAD
45```
46 
47Then setup your client to use the MCP server. Assuming you've installed the binary with `go install github.com/sammcj/mcp-package-version/v2@HEAD` and your `$GOPATH` is `/Users/sammcj/go/bin`, you can provide the full path to the binary:
48 
49```json
50{
51  "mcpServers": {
52    "package-version": {
53      "command": "/Users/sammcj/go/bin/mcp-package-version"
54    }
55  }
56}
57```
58 
59- For the Cline VSCode Extension this will be `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
60- For Claude Desktop `~/Library/Application\ Support/Claude/claude_desktop_config.json`
61- For GoMCP `~/.config/gomcp/config.yaml`
62 
63### Other Installation Methods
64 
65Or clone the repository and build it:
66 
67```bash
68git clone https://github.com/sammcj/mcp-package-version.git
69cd mcp-package-version
70make
71```
72 
73You can also run the server in a container:
74 
75```bash
76docker run -p 18080:18080 ghcr.io/sammcj/mcp-package-version:main
77```
78 
79Note: If running in a container, you'll need to configure the client to use the URL instead of command, e.g.:
80 
81```json
82{
83  "mcpServers": {
84    "package-version": {
85      "url": "http://localhost:18080",
86    }
87  }
88}
89```
90 
91#### Tip: Go Path
92 
93If `$GOPATH/bin` is not in your `PATH`, you'll need to provide the full path to the binary when configuring your MCP client (e.g. `/Users/sammcj/go/bin/mcp-package-version`).
94 
95If you haven't used go applications before and have only just installed go, you may not have a `$GOPATH` set up in your environment. This is important for any `go install` command to work correctly.
96 
97> **Understanding `$GOPATH`**
98>
99> The `go install` command downloads and compiles Go packages, placing the resulting binary executable in the `bin` subdirectory of your `$GOPATH`. By default, `$GOPATH` is > usually located at `$HOME/go` on Unix-like systems (including macOS). If you haven't configured `$GOPATH` explicitly, Go uses this default.
100>
101> The location `$GOPATH/bin` (e.g., `/Users/your_username/go/bin`) needs to be included in your system's `PATH` environment variable if you want to run installed Go binaries directly by name from any terminal location.
102>
103> You can add the following line to your shell configuration file (e.g., `~/.zshrc`, `~/.bashrc`) to set `$GOPATH` to the default if it's not already set, and ensure `$GOPATH/bin` is in your `PATH`:
104>
105> ```bash
106> [ -z "$GOPATH" ] && export GOPATH="$HOME/go"; echo "$PATH" | grep -q ":$GOPATH/bin" || export PATH="$PATH:$GOPATH/bin"
107> ```
108>
109> After adding this line, restart your terminal or MCP client.
110 
111## Usage
112 
113The server supports two transport modes: stdio (default) and SSE (Server-Sent Events).
114 
115### STDIO Transport (Default)
116 
117```bash
118mcp-package-version
119```
120 
121### SSE Transport
122 
123```bash
124mcp-package-version --transport sse --port 18080 --base-url "http://localhost:18080"
125```
126 
127This would make the server available to clients at `http://localhost:18080/sse` (Note the `/sse` suffix!).
128 
129#### Command-line Options
130 
131- `--transport`, `-t`: Transport type (stdio or sse). Default: stdio
132- `--port`: Port to use for SSE transport. Default: 18080
133- `--base-url`: Base URL for SSE transport. Default: http://localhost
134 
135### Docker Images
136 
137Docker images are available from GitHub Container Registry:
138 
139```bash
140docker pull ghcr.io/sammcj/mcp-package-version:main
141```
142 
143You can also see the example [docker-compose.yaml](docker-compose.yaml).
144 
145## Tools
146 
147### NPM Packages
148 
149Check the latest versions of NPM packages:
150 
151```json
152{
153  "name": "check_npm_versions",
154  "arguments": {
155    "dependencies": {
156      "react": "^17.0.2",
157      "react-dom": "^17.0.2",
158      "lodash": "4.17.21"
159    },
160    "constraints": {
161      "react": {
162        "majorVersion": 17
163      }
164    }
165  }
166}
167```
168 
169### Python Packages (requirements.txt)
170 
171Check the latest versions of Python packages from requirements.txt:
172 
173```json
174{
175  "name": "check_python_versions",
176  "arguments": {
177    "requirements": [
178      "requests==2.28.1",
179      "flask>=2.0.0",
180      "numpy"
181    ]
182  }
183}
184```
185 
186### Python Packages (pyproject.toml)
187 
188Check the latest versions of Python packages from pyproject.toml:
189 
190```json
191{
192  "name": "check_pyproject_versions",
193  "arguments": {
194    "dependencies": {
195      "dependencies": {
196        "requests": "^2.28.1",
197        "flask": ">=2.0.0"
198      },
199      "optional-dependencies": {
200        "dev": {
201          "pytest": "^7.0.0"
202        }
203      },
204      "dev-dependencies": {
205        "black": "^22.6.0"
206      }
207    }
208  }
209}
210```
211 
212### Java Packages (Maven)
213 
214Check the latest versions of Java packages from Maven:
215 
216```json
217{
218  "name": "check_maven_versions",
219  "arguments": {
220    "dependencies": [
221      {
222        "groupId": "org.springframework.boot",
223        "artifactId": "spring-boot-starter-web",
224        "version": "2.7.0"
225      },
226      {
227        "groupId": "com.google.guava",
228        "artifactId": "guava",
229        "version": "31.1-jre"
230      }
231    ]
232  }
233}
234```
235 
236### Java Packages (Gradle)
237 
238Check the latest versions of Java packages from Gradle:
239 
240```json
241{
242  "name": "check_gradle_versions",
243  "arguments": {
244    "dependencies": [
245      {
246        "configuration": "implementation",
247        "group": "org.springframework.boot",
248        "name": "spring-boot-starter-web",
249        "version": "2.7.0"
250      },
251      {
252        "configuration": "testImplementation",
253        "group": "junit",
254        "name": "junit",
255        "version": "4.13.2"
256      }
257    ]
258  }
259}
260```
261 
262### Go Packages
263 
264Check the latest versions of Go packages from go.mod:
265 
266```json
267{
268  "name": "check_go_versions",
269  "arguments": {
270    "dependencies": {
271      "module": "github.com/example/mymodule",
272      "require": [
273        {
274          "path": "github.com/gorilla/mux",
275          "version": "v1.8.0"
276        },
277        {
278          "path": "github.com/spf13/cobra",
279          "version": "v1.5.0"
280        }
281      ]
282    }
283  }
284}
285```
286 
287### Docker Images
288 
289Check available tags for Docker images:
290 
291```json
292{
293  "name": "check_docker_tags",
294  "arguments": {
295    "image": "nginx",
296    "registry": "dockerhub",
297    "limit": 5,
298    "filterTags": ["^1\\."],
299    "includeDigest": true
300  }
301}
302```
303 
304### AWS Bedrock Models
305 
306List all AWS Bedrock models:
307 
308```json
309{
310  "name": "check_bedrock_models",
311  "arguments": {
312    "action": "list"
313  }
314}
315```
316 
317Search for specific AWS Bedrock models:
318 
319```json
320{
321  "name": "check_bedrock_models",
322  "arguments": {
323    "action": "search",
324    "query": "claude",
325    "provider": "anthropic"
326  }
327}
328```
329 
330Get the latest Claude Sonnet model:
331 
332```json
333{
334  "name": "get_latest_bedrock_model",
335  "arguments": {}
336}
337```
338 
339### Swift Packages
340 
341Check the latest versions of Swift packages:
342 
343```json
344{
345  "name": "check_swift_versions",
346  "arguments": {
347    "dependencies": [
348      {
349        "url": "https://github.com/apple/swift-argument-parser",
350        "version": "1.1.4"
351      },
352      {
353        "url": "https://github.com/vapor/vapor",
354        "version": "4.65.1"
355      }
356    ],
357    "constraints": {
358      "https://github.com/apple/swift-argument-parser": {
359        "majorVersion": 1
360      }
361    }
362  }
363}
364```
365 
366### GitHub Actions
367 
368Check the latest versions of GitHub Actions:
369 
370```json
371{
372  "name": "check_github_actions",
373  "arguments": {
374    "actions": [
375      {
376        "owner": "actions",
377        "repo": "checkout",
378        "currentVersion": "v3"
379      },
380      {
381        "owner": "actions",
382        "repo": "setup-node",
383        "currentVersion": "v3"
384      }
385    ],
386    "includeDetails": true
387  }
388}
389```
390 
391## Releases and CI/CD
392 
393This project uses GitHub Actions for continuous integration and deployment. The workflow automatically:
394 
3951. Builds and tests the application on every push to the main branch and pull requests
3962. Creates a release when a tag with the format `v*` (e.g., `v1.0.0`) is pushed
3973. Builds and pushes Docker images to GitHub Container Registry
398 
399## License
400 
401[MIT](LICENSE)
402