{"id":24114744,"url":"https://github.com/sammcj/mcp-package-version","last_synced_at":"2025-04-09T06:11:46.222Z","repository":{"id":268346453,"uuid":"904035732","full_name":"sammcj/mcp-package-version","owner":"sammcj","description":"An MCP server that provides LLMs with the latest stable package versions when coding","archived":false,"fork":false,"pushed_at":"2025-03-22T00:59:47.000Z","size":1502,"stargazers_count":59,"open_issues_count":0,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T04:08:55.966Z","etag":null,"topics":["ai","javascript","llm","mcp","node","package","python","security","tool","typescript","versioning","versions"],"latest_commit_sha":null,"homepage":"https://smcleod.net","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sammcj.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["sammcj"],"buy_me_a_coffee":"sam.mcleod"}},"created_at":"2024-12-16T06:07:05.000Z","updated_at":"2025-04-02T00:58:05.000Z","dependencies_parsed_at":"2024-12-16T08:18:49.478Z","dependency_job_id":"bf979751-bb2e-4f52-bfee-735e001771de","html_url":"https://github.com/sammcj/mcp-package-version","commit_stats":null,"previous_names":["sammcj/mcp-package-version"],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammcj%2Fmcp-package-version","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammcj%2Fmcp-package-version/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammcj%2Fmcp-package-version/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammcj%2Fmcp-package-version/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sammcj","download_url":"https://codeload.github.com/sammcj/mcp-package-version/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247987285,"owners_count":21028895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","javascript","llm","mcp","node","package","python","security","tool","typescript","versioning","versions"],"created_at":"2025-01-11T05:18:55.449Z","updated_at":"2025-04-09T06:11:46.215Z","avatar_url":"https://github.com/sammcj.png","language":"TypeScript","funding_links":["https://github.com/sponsors/sammcj","https://buymeacoffee.com/sam.mcleod"],"categories":["Developer Tools","Development Tools Mcp Servers","🤖 AI/ML","Legend","پیاده‌سازی‌های سرور","Uncategorized","Search \u0026 Data Extraction","APIs and HTTP Requests","カテゴリ","📚 Projects (2474 total)","Table of Contents","Server Implementations"],"sub_categories":["Package Managers","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eDeveloper Tools","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","Uncategorized","How to Submit","💻 \u003ca name=\"code--ide\"\u003e\u003c/a\u003eコード・IDE","MCP Servers","AI Services"],"readme":"# Package Version MCP Server\n\n[![smithery badge](https://smithery.ai/badge/mcp-package-version)](https://smithery.ai/server/mcp-package-version)\n\nAn MCP server that provides tools for checking latest stable package versions from multiple package registries:\n\n- npm (Node.js/JavaScript)\n- PyPI (Python)\n- Maven Central (Java)\n- Go Proxy (Go)\n- Swift Packages (Swift)\n- AWS Bedrock (AI Models)\n- Docker Hub (Container Images)\n- GitHub Container Registry (Container Images)\n- GitHub Actions\n\nThis server helps LLMs ensure they're recommending up-to-date package versions when writing code.\n\n**IMPORTANT: As of version 2.0.0, mcp-package-version has been rewritten in Go, as such the configuration needs to be updated in your client - see the [Installation](#installation) section for more details.**\n\n\u003ca href=\"https://glama.ai/mcp/servers/zkts2w92ba\"\u003e\u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/zkts2w92ba/badge\" alt=\"https://github.com/sammcj/mcp-package-version MCP server\" /\u003e\u003c/a\u003e\n\n## Screenshot\n\n![tooling with and without mcp-package-version](images/with-without.jpg)\n\n## Installation\n\nRequirements:\n\n- A modern go version installed (See [Go Installation](https://go.dev/doc/install))\n\nUsing `go install` (Recommended for MCP Client Setup):\n\n```bash\ngo install github.com/sammcj/mcp-package-version/v2@HEAD\n```\n\nThen 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:\n\n```json\n{\n  \"mcpServers\": {\n    \"package-version\": {\n      \"command\": \"/Users/sammcj/go/bin/mcp-package-version\"\n    }\n  }\n}\n```\n\n- For the Cline VSCode Extension this will be `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n- For Claude Desktop `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n- For GoMCP `~/.config/gomcp/config.yaml`\n\n### Other Installation Methods\n\nOr clone the repository and build it:\n\n```bash\ngit clone https://github.com/sammcj/mcp-package-version.git\ncd mcp-package-version\nmake\n```\n\nYou can also run the server in a container:\n\n```bash\ndocker run -p 18080:18080 ghcr.io/sammcj/mcp-package-version:latest\n```\n\nNote: If running in a container, you'll need to configure the client to use the URL instead of command, e.g.:\n\n```json\n{\n  \"mcpServers\": {\n    \"package-version\": {\n      \"url\": \"http://localhost:18080\",\n    }\n  }\n}\n```\n\n#### Tip: Go Path\n\nIf `$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`).\n\nIf 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.\n\n\u003e **Understanding `$GOPATH`**\n\u003e\n\u003e 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 \u003e usually located at `$HOME/go` on Unix-like systems (including macOS). If you haven't configured `$GOPATH` explicitly, Go uses this default.\n\u003e\n\u003e 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.\n\u003e\n\u003e 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`:\n\u003e\n\u003e ```bash\n\u003e [ -z \"$GOPATH\" ] \u0026\u0026 export GOPATH=\"$HOME/go\"; echo \"$PATH\" | grep -q \":$GOPATH/bin\" || export PATH=\"$PATH:$GOPATH/bin\"\n\u003e ```\n\u003e\n\u003e After adding this line, restart your terminal or MCP client.\n\n## Usage\n\nThe server supports two transport modes: stdio (default) and SSE (Server-Sent Events).\n\n### STDIO Transport (Default)\n\n```bash\nmcp-package-version\n```\n\nOr if you built it locally:\n\n```bash\n./bin/mcp-package-version\n```\n\n### SSE Transport\n\n```bash\nmcp-package-version --transport sse --port 18080 --base-url http://localhost\n```\n\nOr if you built it locally:\n\n```bash\n./bin/mcp-package-version --transport sse --port 18080 --base-url http://localhost\n```\n\n#### Command-line Options\n\n- `--transport`, `-t`: Transport type (stdio or sse). Default: stdio\n- `--port`: Port to use for SSE transport. Default: 18080\n- `--base-url`: Base URL for SSE transport. Default: http://localhost\n\n## Tools\n\n### NPM Packages\n\nCheck the latest versions of NPM packages:\n\n```json\n{\n  \"name\": \"check_npm_versions\",\n  \"arguments\": {\n    \"dependencies\": {\n      \"react\": \"^17.0.2\",\n      \"react-dom\": \"^17.0.2\",\n      \"lodash\": \"4.17.21\"\n    },\n    \"constraints\": {\n      \"react\": {\n        \"majorVersion\": 17\n      }\n    }\n  }\n}\n```\n\n### Python Packages (requirements.txt)\n\nCheck the latest versions of Python packages from requirements.txt:\n\n```json\n{\n  \"name\": \"check_python_versions\",\n  \"arguments\": {\n    \"requirements\": [\n      \"requests==2.28.1\",\n      \"flask\u003e=2.0.0\",\n      \"numpy\"\n    ]\n  }\n}\n```\n\n### Python Packages (pyproject.toml)\n\nCheck the latest versions of Python packages from pyproject.toml:\n\n```json\n{\n  \"name\": \"check_pyproject_versions\",\n  \"arguments\": {\n    \"dependencies\": {\n      \"dependencies\": {\n        \"requests\": \"^2.28.1\",\n        \"flask\": \"\u003e=2.0.0\"\n      },\n      \"optional-dependencies\": {\n        \"dev\": {\n          \"pytest\": \"^7.0.0\"\n        }\n      },\n      \"dev-dependencies\": {\n        \"black\": \"^22.6.0\"\n      }\n    }\n  }\n}\n```\n\n### Java Packages (Maven)\n\nCheck the latest versions of Java packages from Maven:\n\n```json\n{\n  \"name\": \"check_maven_versions\",\n  \"arguments\": {\n    \"dependencies\": [\n      {\n        \"groupId\": \"org.springframework.boot\",\n        \"artifactId\": \"spring-boot-starter-web\",\n        \"version\": \"2.7.0\"\n      },\n      {\n        \"groupId\": \"com.google.guava\",\n        \"artifactId\": \"guava\",\n        \"version\": \"31.1-jre\"\n      }\n    ]\n  }\n}\n```\n\n### Java Packages (Gradle)\n\nCheck the latest versions of Java packages from Gradle:\n\n```json\n{\n  \"name\": \"check_gradle_versions\",\n  \"arguments\": {\n    \"dependencies\": [\n      {\n        \"configuration\": \"implementation\",\n        \"group\": \"org.springframework.boot\",\n        \"name\": \"spring-boot-starter-web\",\n        \"version\": \"2.7.0\"\n      },\n      {\n        \"configuration\": \"testImplementation\",\n        \"group\": \"junit\",\n        \"name\": \"junit\",\n        \"version\": \"4.13.2\"\n      }\n    ]\n  }\n}\n```\n\n### Go Packages\n\nCheck the latest versions of Go packages from go.mod:\n\n```json\n{\n  \"name\": \"check_go_versions\",\n  \"arguments\": {\n    \"dependencies\": {\n      \"module\": \"github.com/example/mymodule\",\n      \"require\": [\n        {\n          \"path\": \"github.com/gorilla/mux\",\n          \"version\": \"v1.8.0\"\n        },\n        {\n          \"path\": \"github.com/spf13/cobra\",\n          \"version\": \"v1.5.0\"\n        }\n      ]\n    }\n  }\n}\n```\n\n### Docker Images\n\nCheck available tags for Docker images:\n\n```json\n{\n  \"name\": \"check_docker_tags\",\n  \"arguments\": {\n    \"image\": \"nginx\",\n    \"registry\": \"dockerhub\",\n    \"limit\": 5,\n    \"filterTags\": [\"^1\\\\.\"],\n    \"includeDigest\": true\n  }\n}\n```\n\n### AWS Bedrock Models\n\nList all AWS Bedrock models:\n\n```json\n{\n  \"name\": \"check_bedrock_models\",\n  \"arguments\": {\n    \"action\": \"list\"\n  }\n}\n```\n\nSearch for specific AWS Bedrock models:\n\n```json\n{\n  \"name\": \"check_bedrock_models\",\n  \"arguments\": {\n    \"action\": \"search\",\n    \"query\": \"claude\",\n    \"provider\": \"anthropic\"\n  }\n}\n```\n\nGet the latest Claude Sonnet model:\n\n```json\n{\n  \"name\": \"get_latest_bedrock_model\",\n  \"arguments\": {}\n}\n```\n\n### Swift Packages\n\nCheck the latest versions of Swift packages:\n\n```json\n{\n  \"name\": \"check_swift_versions\",\n  \"arguments\": {\n    \"dependencies\": [\n      {\n        \"url\": \"https://github.com/apple/swift-argument-parser\",\n        \"version\": \"1.1.4\"\n      },\n      {\n        \"url\": \"https://github.com/vapor/vapor\",\n        \"version\": \"4.65.1\"\n      }\n    ],\n    \"constraints\": {\n      \"https://github.com/apple/swift-argument-parser\": {\n        \"majorVersion\": 1\n      }\n    }\n  }\n}\n```\n\n### GitHub Actions\n\nCheck the latest versions of GitHub Actions:\n\n```json\n{\n  \"name\": \"check_github_actions\",\n  \"arguments\": {\n    \"actions\": [\n      {\n        \"owner\": \"actions\",\n        \"repo\": \"checkout\",\n        \"currentVersion\": \"v3\"\n      },\n      {\n        \"owner\": \"actions\",\n        \"repo\": \"setup-node\",\n        \"currentVersion\": \"v3\"\n      }\n    ],\n    \"includeDetails\": true\n  }\n}\n```\n\n## Releases and CI/CD\n\nThis project uses GitHub Actions for continuous integration and deployment. The workflow automatically:\n\n1. Builds and tests the application on every push to the main branch and pull requests\n2. Creates a release when a tag with the format `v*` (e.g., `v1.0.0`) is pushed\n3. Builds and pushes Docker images to GitHub Container Registry\n\n### Docker Images\n\nDocker images are available from GitHub Container Registry:\n\n```bash\ndocker pull ghcr.io/sammcj/mcp-package-version:latest\n```\n\nOr with a specific version:\n\n```bash\ndocker pull ghcr.io/sammcj/mcp-package-version:v2.0.0\n```\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsammcj%2Fmcp-package-version","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsammcj%2Fmcp-package-version","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsammcj%2Fmcp-package-version/lists"}