What is Pypi Mcp Server

PyPI-MCP-Server is a bridge that enables AI assistants to search and access information from the PyPI package repository through a simple Model Context Protocol (MCP) interface.

Use cases

Use cases include searching for Python packages based on specific criteria, retrieving package metadata for analysis, obtaining version history for dependency management, and gathering download statistics for usage insights.

How to use

To use PyPI-MCP-Server, clone the repository, install the required dependencies, and run the server using Python. The server will communicate with MCP clients through standard input/output.

Key features

Key features include package search by keywords, detailed metadata access for packages, retrieval of all released versions, download statistics, and efficient retrieval of package information.

Where to use

PyPI-MCP-Server can be used in AI applications that require access to Python package information, such as chatbots, virtual assistants, and automated development tools.

PyPI MCP Server

🔍 Enabling AI assistants to search and access PyPI package information through a simple MCP interface.

PyPI MCP Server provides a bridge to the PyPI package repository for AI assistants through the Model Context Protocol (MCP). It allows AI models to programmatically search Python packages and access their metadata, supporting features like retrieving package information, searching packages, viewing version history, and download statistics.

✨ Core Features

• 🔎 Package Search: Query PyPI packages by keywords ✅
• 📊 Metadata Access: Get detailed metadata for specific packages ✅
• 📦 Version Information: Get all released versions of a package ✅
• 📈 Statistics Data: Get download statistics for packages ✅
• 🚀 Efficient Retrieval: Fast access to package information ✅

🚀 Quick Start

Prerequisites

• Python 3.10+
• httpx
• BeautifulSoup4
• mcp-python-sdk
• typing-extensions

Installation

1. Clone the repository:

   git clone https://github.com/JackKuo666/PyPI-MCP-Server.git
   cd PyPI-MCP-Server
   

2. Install required dependencies:

   pip install -r requirements.txt
   

Running the Server

python pypi_server.py

The server will communicate with MCP clients through standard input/output (stdio).

📚 MCP Tools

Get Package Information

get_package_info(package_name: str, version: Optional[str] = None) -> Dict

Get detailed information about a specified package, with optional version specification.

Search Packages

search_packages(query: str) -> List[Dict]

Search PyPI packages by keywords.

Get Package Releases

get_package_releases(package_name: str) -> Dict

Get all released version information for a specified package.

Get Package Statistics

get_package_stats(package_name: str) -> Dict

Get download statistics for a specified package.

🔧 Configuration

The server uses the MCP protocol to communicate with clients through standard input/output (stdio), no network port configuration needed.

📋 Integration with AI Assistants

Using Claude Desktop

Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "pypi": {
      "command": "python",
      "args": [
        "pypi_server.py"
      ]
    }
  }
}

Usage Examples

In your AI assistant, you can call the PyPI MCP tools as follows:

Use PyPI tool to search for Flask package:
@pypi search_packages("flask")

Get detailed information about a specific package:
@pypi get_package_info("requests")

Get information about a specific version of a package:
@pypi get_package_info("django", "4.2.0")

View all released versions of a package:
@pypi get_package_releases("numpy")

Get download statistics for a package:
@pypi get_package_stats("pandas")

📄 License

MIT