
A security-focused Model Context Protocol (MCP) server that helps AI agents write safer Python code.
A security-focused Model Context Protocol (MCP) server that helps AI agents write safer Python code. Search packages, scan for vulnerabilities, audit dependencies, and ensure security across your entire Python project.
·
A Model Context Protocol (MCP) server that gives AI assistants accurate PyPI data and vulnerability checks, so the dependencies they suggest exist, are current, and have no known security advisories.
Upgrading from 3.x? The tool set changed. See Upgrading from 3.x.
requirements*.txt, constraints*.txt, pyproject.toml (including Poetry), setup.py (parsed, never executed), setup.cfg, Pipfile, Pipfile.lock, poetry.lock and conda environment.yml (pip section).check_packages).Requires Python 3.11 or newer.
# Run without installing (recommended for MCP clients)
uvx mcp-pypi serve
# Or install it
pip install mcp-pypi
mcp-pypi serveserve uses the stdio transport by default, which is what MCP clients that launch the server themselves expect. For HTTP, see HTTP mode.
Add the server to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"mcp-pypi": {
"command": "uvx",
"args": ["mcp-pypi", "serve"]
}
}
}Restart Claude Desktop after saving. If you installed with pip, use "command": "mcp-pypi" and "args": ["serve"] instead (give the absolute path if Claude Desktop cannot find it).
claude mcp add mcp-pypi -- uvx mcp-pypi serveThe server is available in your next Claude Code session.
Cursor supports MCP servers through configuration files. Configure mcp-pypi globally (all projects) or per project.
Cmd+, on Mac, Ctrl+, on Windows/Linux)Global Configuration (available in all projects):
| Platform | Location |
|---|---|
| macOS/Linux | ~/.cursor/mcp.json |
| Windows | C:\Users\YourUsername\.cursor\mcp.json |
Project Configuration (project-specific):
Create .cursor/mcp.json in your project root.
Add mcp-pypi to your mcp.json file:
{
"mcpServers": {
"mcp-pypi": {
"command": "uvx",
"args": ["mcp-pypi", "serve"]
}
}
}With custom options:
{
"mcpServers": {
"mcp-pypi": {
"command": "uvx",
"args": ["mcp-pypi", "serve", "--log-level", "DEBUG"],
"env": {
"PYPI_CACHE_DIR": "/path/to/cache"
}
}
}
}| Issue | Solution |
|---|---|
| Tools not appearing | Ensure Cursor is in Agent Mode, not Ask Mode |
| Server not starting | Check uvx (or mcp-pypi) is installed and in PATH |
| Configuration errors | Open Output panel (Cmd+Shift+U) and select "MCP Logs" |
| Server crashes | Toggle server off/on in Settings without removing config |
For clients that connect over the network instead of launching the server:
mcp-pypi serve --transport httpThe server listens on http://127.0.0.1:8143/mcp (streamable HTTP). Change the bind address with --host and --port. There is no authentication, so only bind to a non-loopback address on a network you trust. See docs/transports.md.
Eleven read-only tools. All of them return structured output with an output schema; failures are reported as MCP tool errors.
| Tool | What it does |
|---|---|
search_packages | Search PyPI package names and return ranked matches with summaries. |
get_package | Get metadata for a package: versions, license, URLs, classifiers and yank status. |
get_package_versions | List released versions with upload time, yank status and file types (paginated). |
compare_versions | Compare two versions of a package using PEP 440 ordering. |
get_package_changelog | Get changelog text from a package's project links or GitHub releases. |
get_download_stats | Get recent download counts (last day, week and month) from pypistats.org. |
get_dependencies | List the requirements of a package, optionally as a transitive tree (depth 1-5). |
check_packages | Check up to 100 package names on PyPI and report latest version and summary. |
check_vulnerabilities | Check up to 100 packages against OSV for known vulnerabilities, optionally with transitive dependencies. |
audit_project | Audit a project's dependency files for vulnerabilities, outdated pins and drift. |
scan_installed_packages | Scan a Python environment's installed packages for known vulnerabilities. |
Parameters and result fields are documented in docs/pypi.md. The server also provides two prompts (analyze_dependencies, compare_packages, both taking arguments) and three read-only resources (pypi://recent-releases, pypi://new-packages, pypi://updated-packages).
PyPI's own search page sits behind a JavaScript challenge, so search_packages does not use it. It searches the PyPI Simple index of package names locally and ranks matches by name similarity and download popularity (an exact name match first, then popular packages such as pyjwt for jwt ahead of obscure name matches). It matches names, not descriptions, so name-like keywords (web scraping is weaker than scrapy or beautifulsoup) work best.
Once configured, you can ask your assistant:
fastapi-users exist, and what is its latest version?"scrape in the name and pick the most popular."| Variable | Default | Meaning |
|---|---|---|
PYPI_CACHE_DIR | per-user cache dir (~/.cache/mcp-pypi on Linux) | Cache directory |
PYPI_CACHE_TTL | 604800 (1 week) | Cache TTL in seconds |
PYPI_CACHE_MAX_SIZE | 104857600 (100 MB) | Maximum cache size in bytes |
PYPI_CACHE_STRATEGY | hybrid | Accepted for compatibility; responses are always cached as files on disk |
PYPI_VULNERABILITY_CACHE_TTL | 3600 (1 hour) | TTL for vulnerability results, in seconds |
PYPI_MAX_RETRIES | 3 | Retries for failed requests |
PYPI_RETRY_DELAY | 1.0 | Base retry delay in seconds (exponential backoff) |
PYPI_TIMEOUT | 30.0 | Request timeout in seconds |
PYPI_USER_AGENT | mcp-pypi/<version> (+https://github.com/kimasplund/mcp-pypi) | User-Agent sent to PyPI and OSV |
mcp-pypi serve also accepts --cache-dir, --cache-strategy, --cache-ttl, --user-agent, --log-level, --host, --port and --transport; flags take precedence over the environment. See docs/caching.md for how caching works.
from pathlib import Path
from mcp_pypi.core.models import PyPIClientConfig
from mcp_pypi.server import build_server
config = PyPIClientConfig(cache_dir=str(Path.home() / ".cache" / "my-pypi-cache"), cache_ttl=7200)
server = build_server(config) # a fastmcp.FastMCP instance
server.run() # stdio
# server.run(transport="http", host="127.0.0.1", port=8143)The CLI calls the same code as the server, which is handy for scripts and CI.
mcp-pypi --version
# Search package names
mcp-pypi search "http client" --limit 10
# Package information
mcp-pypi package info requests
mcp-pypi package version django
mcp-pypi package releases numpy
mcp-pypi package dependencies flask
mcp-pypi package compare pandas 2.0.0 2.1.0
# Download statistics (last day, week, month)
mcp-pypi stats downloads requests
# Audit a project directory or a single dependency file
mcp-pypi check-requirements .
mcp-pypi check-requirements requirements.txt --format json --full
# Cache
mcp-pypi cache stats
mcp-pypi cache clearcheck-requirements runs the same audit as the audit_project tool. It exits 1 if any dependency has a known vulnerability, 2 on an error, and 0 otherwise. An audit that could not check some dependencies but found no vulnerabilities also exits 0; the unchecked dependencies are listed in the output, so read it (or use --format json and check totals.unchecked) if you gate CI on it.
The client cannot start the server
uvx or mcp-pypi in the client config if it is not on the client's PATH.uvx mcp-pypi serve --log-level DEBUG in a terminal to see startup errors. Logs go to stderr so they do not corrupt the stdio stream.Search returns nothing or reports the index is unavailable
Stale data
mcp-pypi cache clear, or lower PYPI_CACHE_TTL.Python version errors
uvx picks a suitable interpreter automatically.Contributions are welcome. Open an issue first for larger changes.
git clone https://github.com/kimasplund/mcp-pypi.git
cd mcp-pypi
uv sync
uv run ruff check
uv run ruff format --check
uv run pyrefly check
uv run pytest # offline tests
uv run pytest -m integration # live network testsMIT. See LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add mcp-pypi -- uvx mcp-pypi serve{
"mcpServers": {
"mcp-pypi": {
"args": [
"mcp-pypi",
"serve"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"mcp-pypi","args":["mcp-pypi","serve"],"command":"uvx"}'[mcp_servers.mcp-pypi]
command = "uvx"
args = ["mcp-pypi", "serve"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-pypi to learn what the "Mcp Pypi" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
uvx mcp-pypi serveclaude mcp add mcp-pypi -- uvx mcp-pypi servepip install mcp-pypiThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-pypi)Nothing comparable is listed yet.
v4.0.1Release notesv4.0.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-pypi" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.