bibliocommons-mcp-package-version-check 1.0.0

MCP server for checking latest package versions across 14 ecosystems

Package Version Check MCP Server

MCP server for checking latest stable package versions across 14 ecosystems. Supports Docker tag hints for suffix matching (e.g., 3.12-alpine), Helm OCI registries, and GitHub Actions metadata lookup with optional README inclusion.

Configuration

No authentication required for most registries. Optional GITHUB_PAT for higher GitHub API rate limits (Swift packages, GitHub Actions).

Environment Variables

Variable	Default	Description
GITHUB_PAT	(none)	GitHub personal access token for higher rate limits
PACKAGE_VERSION_TIMEOUT	15	HTTP request timeout in seconds
PACKAGE_VERSION_TRANSPORT	stdio	Transport mode: stdio or http
PACKAGE_VERSION_PORT	8000	Port for HTTP transport mode

Installation

Option 1: Using uvx (Recommended)

curl -LsSf https://astral.sh/uv/install.sh | sh

No additional installation needed — uvx handles dependencies automatically.

Option 2: Using pip

pip install bibliocommons-mcp-package-version-check
# or for development
pip install -e ".[dev]"

Option 3: Docker

cd .. && docker build -f package-version-check/Dockerfile -t package-version-check-mcp:latest .
docker run --rm package-version-check-mcp:latest

AI Client Setup

Quick Links: Amazon Q | Claude Desktop | VS Code | GitHub Copilot | Cline | Zed | Cursor | Kiro IDE | Kiro CLI

Amazon Q Developer (VS Code)

{
  "amazonQ.mcp.servers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

VS Code (with MCP Extension)

{
  "mcp.servers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

GitHub Copilot (VS Code)

{
  "github.copilot.chat.mcp.servers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Cline (VS Code Extension)

{
  "cline.mcpServers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Zed Editor

{
  "mcpServers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Cursor IDE

{
  "mcp.servers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Kiro IDE

{
  "mcpServers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Kiro CLI

Create or edit ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "package-version-check": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/package-version-check", "bibliocommons-mcp-package-version-check"]
    }
  }
}

Configuration Notes

• Replace /absolute/path/to/package-version-check/ with the actual path to your server directory
• Set GITHUB_PAT environment variable for higher GitHub API rate limits
• After adding the configuration, restart your AI client for changes to take effect

Supported Ecosystems

Ecosystem	Registry	Package Format
npm	npmjs.org	express, @angular/core
pypi	pypi.org	requests, django
nuget	nuget.org	Newtonsoft.Json
maven_gradle	Maven Central / Google Maven	group:artifact or google:group:artifact
go	proxy.golang.org	golang.org/x/net
php	packagist.org	laravel/framework
rubygems	rubygems.org	rails
rust	crates.io	serde
swift	GitHub tags	github.com/owner/repo
dart	pub.dev	flutter
docker	Docker Hub / any registry	python, ghcr.io/org/image
helm	ChartMuseum / OCI	https://repo/chart or oci://registry/chart
terraform_provider	Terraform Registry	hashicorp/aws
terraform_module	Terraform Registry	hashicorp/consul/aws

Examples

Check package versions

{
  "tool": "get_latest_package_versions",
  "arguments": {
    "packages": [
      {"ecosystem": "npm", "package_name": "express"},
      {"ecosystem": "pypi", "package_name": "django"},
      {"ecosystem": "docker", "package_name": "python", "version_hint": "3.12-alpine"},
      {"ecosystem": "helm", "package_name": "oci://ghcr.io/org/charts/app"},
      {"ecosystem": "terraform_provider", "package_name": "hashicorp/aws"}
    ]
  }
}

Check GitHub Actions

{
  "tool": "get_github_action_versions",
  "arguments": {
    "action_names": ["actions/checkout", "docker/login-action"],
    "include_readme": false
  }
}

Standalone MCP Server

python -m bibliocommons_mcp_package_version_check
# or with HTTP transport
python -m bibliocommons_mcp_package_version_check --transport http --port 8000

Security Notes

• No credentials required for public registries
• GITHUB_PAT is optional and only needed for higher rate limits
• All requests use HTTPS
• Docker registry auth tokens are ephemeral (per-request)