Compare commits
No commits in common. "a14277d773fd6c62bc67e659e786ec4e42220991" and "197b2ac940f0b995dd56ccb7f46e9df588e4b0f8" have entirely different histories.
a14277d773
...
197b2ac940
190
README.md
190
README.md
@ -1,93 +1,35 @@
|
||||
# 🎤 mcpypi 🥧
|
||||
### *Your Master of Ceremonies for PyPI*
|
||||
# PyPI Query MCP Server
|
||||
|
||||
<div align="center">
|
||||
[](https://pypi.org/project/mcpypi/)
|
||||
|
||||
[](https://pypi.org/project/mcpypi/)
|
||||
[](https://pypi.org/project/mcpypi/)
|
||||
[](https://pypi.org/project/mcpypi/)
|
||||
[](https://github.com/loonghao/pypi-query-mcp-server/blob/main/LICENSE)
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
> **mcpypi** (pronounced "MC-py-pie") is your **Master of Ceremonies** for PyPI! 🎤
|
||||
>
|
||||
> *The ultimate PyPI package intelligence platform, now available through Model Context Protocol*
|
||||
|
||||
Just like a world-class DJ or MC controls the music and keeps the party flowing, **mcpypi** orchestrates your entire Python package ecosystem. It's the perfect fusion of "**MCP**" + "**PyPI**" + the Python community's beloved tradition of naming everything with "**pie**" 🥧 (NumPy, SciPy, SymPy... you get it!).
|
||||
|
||||
Think of mcpypi as your **intelligent package DJ** - it knows all the tracks (packages), their dependencies, security vulnerabilities, licenses, and can help you mix the perfect environment for your Python projects!
|
||||
|
||||
## 🌟 Why mcpypi?
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%">
|
||||
|
||||
### 🎯 **37 Powerful Tools**
|
||||
Complete PyPI analysis suite across 8 categories
|
||||
|
||||
### 🔒 **Security First**
|
||||
OSV database integration + GitHub advisories
|
||||
|
||||
### 📊 **Real-time Analytics**
|
||||
Live download stats, trends, and rankings
|
||||
|
||||
### 🏥 **Health Scoring**
|
||||
7-category package quality assessment
|
||||
|
||||
</td>
|
||||
<td width="50%">
|
||||
|
||||
### 📄 **License Intelligence**
|
||||
SPDX compatibility analysis + risk assessment
|
||||
|
||||
### 🔍 **Deep Analysis**
|
||||
Dependency trees, requirements parsing, bulk operations
|
||||
|
||||
### ⚡ **Lightning Fast**
|
||||
Async operations with intelligent caching
|
||||
|
||||
### 🎤 **MCP Integration**
|
||||
Works with Claude Code, Claude Desktop, Cursor, and more!
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
A Model Context Protocol (MCP) server for querying PyPI package information, dependencies, and compatibility checking.
|
||||
|
||||
## Features
|
||||
|
||||
Your MC knows how to drop the beats! 🎵
|
||||
- 📦 Query PyPI package information (name, version, description, dependencies)
|
||||
- 🐍 Python version compatibility checking
|
||||
- 🔍 **Advanced dependency analysis and recursive resolution**
|
||||
- 📥 **Package download with dependency collection**
|
||||
- 📊 **Download statistics and popularity analysis**
|
||||
- 🏆 **Top packages ranking and trends**
|
||||
- 🎯 **MCP prompt templates for guided analysis and decision-making**
|
||||
- 🏢 Private PyPI repository support
|
||||
- ⚡ Fast async operations with caching
|
||||
- 🛠️ Easy integration with MCP clients
|
||||
|
||||
- 📦 **Track Info** - Get the full story on any PyPI package (metadata, versions, dependencies)
|
||||
- 🐍 **Compatibility Check** - Know which Python versions can handle your tracks
|
||||
- 🔍 **Deep Mixing** - Advanced dependency analysis and recursive resolution to avoid conflicts
|
||||
- 📥 **Collection Building** - Download packages with all their dependencies for offline mixing
|
||||
- 📊 **Chart Analysis** - Real-time download statistics and popularity trends
|
||||
- 🏆 **Top 40** - Discover the hottest packages trending right now
|
||||
- 🔒 **Security Scanning** - Keep your playlist safe from vulnerable packages
|
||||
- 📄 **License Mixing** - Ensure your package mix is legally compatible
|
||||
- 🏥 **Health Check** - Assess package quality across 7 key metrics
|
||||
- 📋 **Setlist Analysis** - Parse and analyze requirements files in any format
|
||||
- 🎯 **Smart Prompts** - MCP templates for guided decision-making
|
||||
- 🏢 **Private Venues** - Support for private PyPI repositories
|
||||
- ⚡ **Live Performance** - Fast async operations with intelligent caching
|
||||
- 🛠️ **Universal Mixer** - Easy integration with all MCP clients
|
||||
## Installation
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
Ready to get your MC on the decks? Here's how to book mcpypi for your next Python party! 🎉
|
||||
|
||||
### Option 1: Lightning Setup ⚡ (Recommended)
|
||||
### Using uvx (recommended)
|
||||
|
||||
```bash
|
||||
# One-liner - Run immediately with uvx
|
||||
# Run directly with uvx
|
||||
uvx mcpypi
|
||||
|
||||
# Or install and run with specific script
|
||||
uvx --from mcpypi mcpypi
|
||||
```
|
||||
|
||||
### Option 2: Traditional Install 📦
|
||||
### Using pip
|
||||
|
||||
```bash
|
||||
# Install from PyPI
|
||||
@ -97,78 +39,7 @@ pip install mcpypi
|
||||
python -m pypi_query_mcp.server
|
||||
```
|
||||
|
||||
### Option 3: Claude Code Integration 🎤
|
||||
|
||||
```bash
|
||||
# Connect directly to Claude Code
|
||||
claude mcp add mcpypi -- uvx mcpypi
|
||||
```
|
||||
|
||||
<div align="center">
|
||||
|
||||
### 🎊 **That's it! Your MC is now live and ready to rock!** 🎊
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## 🎭 Live Demo
|
||||
|
||||
Here's what your MC can do for you:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center">
|
||||
|
||||
### 🔍 **Package Intelligence**
|
||||
```python
|
||||
"What are the security vulnerabilities
|
||||
in Django 4.1?"
|
||||
```
|
||||
*Get real-time security analysis with OSV database*
|
||||
|
||||
</td>
|
||||
<td align="center">
|
||||
|
||||
### 📊 **Trend Analysis**
|
||||
```python
|
||||
"Show me the top 10 trending
|
||||
ML packages this week"
|
||||
```
|
||||
*Live PyPI download trends and rankings*
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center">
|
||||
|
||||
### 🏥 **Health Scoring**
|
||||
```python
|
||||
"Compare the health scores of
|
||||
FastAPI vs Django vs Flask"
|
||||
```
|
||||
*7-category quality assessment with GitHub metrics*
|
||||
|
||||
</td>
|
||||
<td align="center">
|
||||
|
||||
### 📄 **License Compliance**
|
||||
```python
|
||||
"Check if my requirements.txt
|
||||
is MIT license compatible"
|
||||
```
|
||||
*SPDX normalization with risk assessment*
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
### 🛠️ Advanced Installation
|
||||
|
||||
<details>
|
||||
<summary><b>Development Setup</b></summary>
|
||||
### From source
|
||||
|
||||
```bash
|
||||
git clone https://github.com/loonghao/pypi-query-mcp-server.git
|
||||
@ -177,24 +48,9 @@ uv sync
|
||||
uv run pypi-query-mcp
|
||||
```
|
||||
|
||||
</details>
|
||||
## Configuration
|
||||
|
||||
---
|
||||
|
||||
## 🎛️ Configuration
|
||||
|
||||
<div align="center">
|
||||
|
||||
**mcpypi works with ALL major MCP clients!**
|
||||
|
||||
[](https://claude.ai/desktop)
|
||||
[](https://claude.ai/code)
|
||||
[](https://cursor.sh/)
|
||||
[](https://codeium.com/windsurf)
|
||||
|
||||
</div>
|
||||
|
||||
### 🖥️ Claude Desktop
|
||||
### Claude Desktop
|
||||
|
||||
Add to your Claude Desktop configuration file:
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user