# 🦸 MCP Package Hero
[](https://pypi.org/project/mcp-package-hero/)
[](https://www.python.org/downloads/)
[](https://github.com/jlowin/fastmcp)
[](https://opensource.org/licenses/MIT)
[](https://github.com/moinsen-dev/mcp-package-hero)
[](https://github.com/moinsen-dev/mcp-package-hero)
[](https://github.com/moinsen-dev/mcp-package-hero)
> A comprehensive Model Context Protocol (MCP) server for checking package versions and rating package quality across Python (PyPI), JavaScript/TypeScript (npm), Dart (pub.dev), and Rust (crates.io).
## 🎯 Purpose
MCP Package Hero helps you make informed decisions about packages by providing:
- **Version Information**: Get the latest stable version of any package
- **Quality Ratings**: Comprehensive quality analysis across multiple dimensions
- **llms.txt Documentation**: Fetch and generate LLM-friendly documentation files
Package Hero focuses on four major ecosystems:
- ✅ Python packages on PyPI
- ✅ JavaScript/TypeScript packages on npm
- ✅ Dart/Flutter packages on pub.dev
- ✅ Rust packages on crates.io
## 🚀 Features
### Version Checking
- **Simple API**: Get latest version for one or multiple packages
- **Fast**: Sub-second response times with async operations
- **Batch Support**: Check up to 10 packages at once
### Quality Rating (v1.1.0+)
- **Comprehensive Analysis**: Multi-dimensional package quality scoring
- 🔧 **Maintenance Health** (35%): Release frequency, issue resolution, PR activity
- 📊 **Popularity** (25%): Downloads, GitHub stars, community adoption
- ✨ **Quality Metrics** (40%): Documentation (35%), license (25%), tests (25%), llms.txt (15%)
- **Letter Grades**: A+ to F rating system for quick assessment
- **Actionable Insights**: Key strengths and red flags for each package
- **Ecosystem Integration**: Leverages native scores (pub.dev pub points, npms.io scores)
- **llms.txt Bonus** (v1.2.0+): Packages with llms.txt get bonus points (70 for llms.txt, 100 for both llms.txt + llms-full.txt)
### llms.txt Support (v1.2.0+)
- **Fetch llms.txt**: Get LLM-friendly documentation from package repositories
- **Generate llms.txt**: Create standardized documentation for your projects
- **Multi-Source**: Searches GitHub, homepages, and documentation sites
- **Validation**: Parses and validates llms.txt format compliance
- **Smart Scanning**: Automatically discovers documentation files in projects
### Technical Excellence
- **LLM-Friendly**: Designed specifically for AI assistants and agents
- **Type-Safe**: Full type hints, Pydantic validation, and mypy compliance
- **Well-Tested**: Comprehensive coverage for all features
- **Production-Ready**: Modern Python best practices, timezone-aware, Pydantic V2
## 📦 Installation
### From PyPI (Recommended)
The fastest and easiest way to use MCP Package Hero is directly from PyPI:
```bash
# No installation needed! Just use uvx to run it directly
uvx mcp-package-hero
# Or install it as a tool for repeated use
uv tool install mcp-package-hero
```
### From Source (Development)
For development or contributing:
```bash
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone the repository
git clone https://github.com/moinsen-dev/mcp-package-hero.git
cd mcp-package-hero
# Install dependencies
uv sync
# Install the package in editable mode
uv pip install -e .
```
## 🔧 Configuration
Add to your MCP client configuration (e.g., Claude Desktop, Cline, etc.):
### Claude Desktop
#### Option 1: From PyPI (Recommended - Fast!)
Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or
`%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"package-hero": {
"command": "uvx",
"args": ["mcp-package-hero"]
}
}
}
```
**Startup time**: ~1-2 seconds (first run), ~0.5 seconds (cached) ⚡
#### Option 2: From GitHub (Slower)
```json
{
"mcpServers": {
"package-hero": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/moinsen-dev/mcp-package-hero.git",
"mcp-package-hero"
]
}
}
}
```
#### Option 3: From local directory (Development)
```json
{
"mcpServers": {
"package-hero": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/mcp-package-hero",
"mcp-package-hero"
]
}
}
}
```
### Cline VSCode Extension
Edit `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:
#### Option 1: From PyPI (Recommended - Fast!)
```json
{
"mcpServers": {
"package-hero": {
"command": "uvx",
"args": ["mcp-package-hero"]
}
}
}
```
#### Option 2: From GitHub (Slower)
```json
{
"mcpServers": {
"package-hero": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/moinsen-dev/mcp-package-hero.git",
"mcp-package-hero"
]
}
}
}
```
#### Option 3: From local directory (Development)
```json
{
"mcpServers": {
"package-hero": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/mcp-package-hero",
"mcp-package-hero"
]
}
}
}
```
### Claude Code
Add the server globally to Claude Code using the CLI:
#### Option 1: From PyPI (Recommended - Fast!)
```bash
claude mcp add-json package-hero '{"type":"stdio","command":"uvx","args":["mcp-package-hero"]}'
```
#### Option 2: From GitHub (Slower)
```bash
claude mcp add-json package-hero '{"type":"stdio","command":"uvx","args":["--from","git+https://github.com/moinsen-dev/mcp-package-hero.git","mcp-package-hero"]}'
```
#### Option 3: From local directory (Development)
```bash
claude mcp add-json package-hero '{"type":"stdio","command":"uv","args":["run","--directory","/path/to/mcp-package-hero","mcp-package-hero"]}'
```
## 📖 Usage
### Tool 1: Get Latest Version
Check the latest version of a single package:
```python
# Example queries for your LLM:
"What's the latest version of requests in Python?"
"Check the current version of react"
"Show me the latest version of the http package for Dart"
"What's the latest version of serde in Rust?"
```
**Tool Name**: `get_latest_version`
**Parameters**:
- `package_name` (string): Name of the package
- `ecosystem` (string): One of "python", "javascript", "dart", or "rust"
**Example Response**:
```json
{
"package_name": "requests",
"ecosystem": "python",
"latest_version": "2.31.0",
"registry_url": "https://pypi.org/project/requests/",
"checked_at": "2025-10-06T10:30:00Z",
"status": "success"
}
```
### Tool 2: Batch Version Check
Check multiple packages at once (max 10):
```python
# Example query:
"Check the latest versions of requests (python), react (javascript), http (dart), and serde (rust)"
```
**Tool Name**: `get_latest_versions_batch`
**Parameters**:
- `packages` (array): List of objects with `package_name` and `ecosystem`
- `max_packages` (integer, optional): Limit (default: 10)
**Example Response**:
```json
{
"results": [
{
"package_name": "requests",
"ecosystem": "python",
"latest_version": "2.31.0",
"status": "success"
},
{
"package_name": "nonexistent-pkg",
"ecosystem": "python",
"latest_version": null,
"status": "not_found"
}
],
"checked_at": "2025-10-06T10:30:00Z"
}
```
### Tool 3: Rate Package Quality (v1.1.0+)
Get comprehensive quality rating for a package:
```python
# Example queries:
"Rate the quality of the requests package"
"How good is the react package?"
"Give me a quality assessment of flutter_bloc"
"How does the serde crate rate?"
```
**Tool Name**: `rate_package`
**Parameters**:
- `package_name` (string): Name of the package
- `ecosystem` (string): One of "python", "javascript", "dart", or "rust"
**Example Response**:
```json
{
"package_name": "requests",
"ecosystem": "python",
"overall_score": 86.6,
"letter_grade": "A-",
"maintenance": {
"score": 78.8,
"last_release_days": 48,
"release_frequency_score": 80.0,
"issue_resolution_score": 100.0,
"pr_merge_score": 44.2
},
"popularity": {
"score": 100.0,
"downloads": 855587647,
"stars": 53340,
"downloads_score": 100.0,
"stars_score": 100.0
},
"quality": {
"score": 85.0,
"has_documentation": true,
"has_license": true,
"has_tests": null,
"documentation_score": 100.0,
"license_score": 100.0,
"test_score": 50.0
},
"repository_url": "https://github.com/psf/requests",
"license": "Apache-2.0",
"description": "Python HTTP for Humans.",
"insights": [
"Strong issue resolution track record",
"Highly popular with 100K+ monthly downloads",
"Well-starred project (1000+ stars)",
"High quality package with good documentation and license"
],
"red_flags": [],
"status": "success"
}
```
### Tool 4: Get llms.txt (v1.2.0+)
Fetch llms.txt documentation file for a package:
```python
# Example queries:
"Get the llms.txt file for fasthtml"
"Show me the documentation structure for react"
"Fetch llms.txt and llms-full.txt for flutter_bloc"
"Get the llms.txt for tokio"
```
**Tool Name**: `get_llms_txt`
**Parameters**:
- `package_name` (string): Name of the package
- `ecosystem` (string): One of "python", "javascript", "dart", or "rust"
- `include_full` (boolean, optional): Also fetch llms-full.txt (default: false)
**Example Response**:
```json
{
"package_name": "fasthtml",
"ecosystem": "python",
"llms_txt_content": {
"project_name": "FastHTML",
"summary": "FastHTML is a python library which brings together Starlette, Uvicorn, HTMX, and fastcore's FT FastTags",
"sections": [
{
"title": "Docs",
"links": [
{
"title": "FastHTML quick start",
"url": "https://fastht.ml/docs/tutorials/quickstart_for_web_devs.html.md",
"description": "Overview of features"
}
]
}
],
"raw_content": "# FastHTML\n\n> FastHTML is a python library...",
"is_valid": true,
"validation_warnings": []
},
"source_url": "https://raw.githubusercontent.com/AnswerDotAI/fasthtml/main/llms.txt",
"source_type": "github_main",
"repository_url": "https://github.com/AnswerDotAI/fasthtml",
"status": "success"
}
```
### Tool 5: Create llms.txt (v1.2.0+)
Generate an llms.txt file for your project:
```python
# Example queries:
"Create an llms.txt file for my project called 'My Library'"
"Generate llms.txt documentation for this codebase"
"Create llms.txt with only documentation and examples sections"
```
**Tool Name**: `create_llms_txt`
**Parameters**:
- `project_name` (string): Name of your project
- `description` (string): Brief project description
- `scan_directory` (string, optional): Directory to scan (default: ".")
- `sections` (list, optional): Specific sections to include (e.g., ["documentation", "examples"])
**Available Sections**: documentation, examples, api, guides, configuration
**Example Response**:
```json
{
"content": "# My Project\n\n> A comprehensive Python library\n\n## Documentation\n\n- [README](README.md): Project overview and getting started\n- [Contributing Guide](CONTRIBUTING.md): Guidelines for contributing\n\n## Examples\n\n- [Basic Example](examples/basic.py): Example code\n",
"discovered_files": {
"documentation": ["README.md", "CONTRIBUTING.md"],
"examples": ["examples/basic.py"]
},
"suggested_path": "./llms.txt",
"status": "success"
}
```
## 🧪 Testing
Run the test suite:
```bash
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=src/mcp_package_hero --cov-report=html
# Run with coverage summary
uv run pytest --cov=src/mcp_package_hero --cov-report=term-missing
# Run specific test file
uv run pytest tests/test_registries/test_pypi.py
```
### Test Results
- ✅ 68/68 tests passing
- ✅ Comprehensive coverage for version checking, rating, and llms.txt features
- ✅ All four ecosystems validated with live API calls
## 🏗️ Development
### Project Structure
```
mcp-package-hero/
├── src/mcp_package_hero/
│ ├── __init__.py
│ ├── server.py # Main FastMCP server
│ ├── models.py # Pydantic models
│ ├── github_client.py # GitHub API client
│ ├── rating_calculator.py # Rating algorithms
│ ├── registries/ # Version checking
│ │ ├── base.py
│ │ ├── pypi.py
│ │ ├── npm.py
│ │ └── pubdev.py
│ └── raters/ # Quality rating
│ ├── python_rater.py
│ ├── javascript_rater.py
│ └── dart_rater.py
├── tests/
├── README.md
└── pyproject.toml
```
### Code Quality
```bash
# Format code
uv run ruff format .
# Lint code
uv run ruff check .
# Auto-fix safe linting issues
uv run ruff check --fix .
# Type check
uv run mypy src/
```
### Quality Standards
- ✅ **Type Safety**: Full mypy compliance with Pydantic plugin
- ✅ **Code Style**: Ruff linting and formatting
- ✅ **Modern Python**: Python 3.10+ type hints (PEP 604)
- ✅ **Timezone-Aware**: All timestamps use UTC timezone
- ✅ **Pydantic V2**: Using latest ConfigDict patterns
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Built with [FastMCP](https://github.com/jlowin/fastmcp) by Prefect
- Inspired by [mcp-package-version](https://github.com/sammcj/mcp-package-version) by Sam McLeod
- Part of the [Model Context Protocol](https://modelcontextprotocol.io) ecosystem
## 📞 Support
- **Issues**: [GitHub Issues](https://github.com/moinsen-dev/mcp-package-hero/issues)
- **Discussions**: [GitHub Discussions](https://github.com/moinsen-dev/mcp-package-hero/discussions)
## 🗺️ Roadmap
### v1.2.0 ✅ (Current)
- [x] llms.txt support - fetch documentation from packages
- [x] llms.txt generation - create documentation for projects
- [x] Multi-source fetching (GitHub, homepages)
- [x] Documentation validation and parsing
### v1.1.0 ✅
- [x] Package quality rating system
- [x] Multi-dimensional scoring (maintenance, popularity, quality)
- [x] GitHub integration for repository metrics
- [x] Integration with ecosystem-native scores (pub.dev, npms.io)
### v1.3.0 ✅
- [x] Rust ecosystem support (crates.io)
- [x] Full integration with existing tools (version checking, quality rating, llms.txt)
- [x] Comprehensive test coverage for Rust packages
### v1.4.0 (Planned)
- [ ] Additional ecosystems (Go, Swift)
- [ ] Cache layer for improved performance
- [ ] Support for specific version queries
### v2.0 (Future)
- [ ] Dependency tree analysis
- [ ] Version compatibility checking
- [ ] Security vulnerability detection
---
Made with ☕️ by [moinsen-dev](https://github.com/moinsen-dev)
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-package-hero",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "mcp, package, version, rating, quality, pypi, npm, pub.dev, fastmcp",
"author": "Ulrich Diedrichsen",
"author_email": "Ulrich Diedrichsen <uli@moinsen.dev>",
"download_url": "https://files.pythonhosted.org/packages/63/fc/32919599a630b94a1ed32ba65c09d0923e8de323081dc949285243600de7/mcp_package_hero-1.3.0.tar.gz",
"platform": null,
"description": "# \ud83e\uddb8 MCP Package Hero\n\n[](https://pypi.org/project/mcp-package-hero/)\n[](https://www.python.org/downloads/)\n[](https://github.com/jlowin/fastmcp)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/moinsen-dev/mcp-package-hero)\n[](https://github.com/moinsen-dev/mcp-package-hero)\n[](https://github.com/moinsen-dev/mcp-package-hero)\n\n> A comprehensive Model Context Protocol (MCP) server for checking package versions and rating package quality across Python (PyPI), JavaScript/TypeScript (npm), Dart (pub.dev), and Rust (crates.io).\n\n## \ud83c\udfaf Purpose\n\nMCP Package Hero helps you make informed decisions about packages by providing:\n- **Version Information**: Get the latest stable version of any package\n- **Quality Ratings**: Comprehensive quality analysis across multiple dimensions\n- **llms.txt Documentation**: Fetch and generate LLM-friendly documentation files\n\nPackage Hero focuses on four major ecosystems:\n- \u2705 Python packages on PyPI\n- \u2705 JavaScript/TypeScript packages on npm\n- \u2705 Dart/Flutter packages on pub.dev\n- \u2705 Rust packages on crates.io\n\n## \ud83d\ude80 Features\n\n### Version Checking\n- **Simple API**: Get latest version for one or multiple packages\n- **Fast**: Sub-second response times with async operations\n- **Batch Support**: Check up to 10 packages at once\n\n### Quality Rating (v1.1.0+)\n- **Comprehensive Analysis**: Multi-dimensional package quality scoring\n - \ud83d\udd27 **Maintenance Health** (35%): Release frequency, issue resolution, PR activity\n - \ud83d\udcca **Popularity** (25%): Downloads, GitHub stars, community adoption\n - \u2728 **Quality Metrics** (40%): Documentation (35%), license (25%), tests (25%), llms.txt (15%)\n- **Letter Grades**: A+ to F rating system for quick assessment\n- **Actionable Insights**: Key strengths and red flags for each package\n- **Ecosystem Integration**: Leverages native scores (pub.dev pub points, npms.io scores)\n- **llms.txt Bonus** (v1.2.0+): Packages with llms.txt get bonus points (70 for llms.txt, 100 for both llms.txt + llms-full.txt)\n\n### llms.txt Support (v1.2.0+)\n- **Fetch llms.txt**: Get LLM-friendly documentation from package repositories\n- **Generate llms.txt**: Create standardized documentation for your projects\n- **Multi-Source**: Searches GitHub, homepages, and documentation sites\n- **Validation**: Parses and validates llms.txt format compliance\n- **Smart Scanning**: Automatically discovers documentation files in projects\n\n### Technical Excellence\n- **LLM-Friendly**: Designed specifically for AI assistants and agents\n- **Type-Safe**: Full type hints, Pydantic validation, and mypy compliance\n- **Well-Tested**: Comprehensive coverage for all features\n- **Production-Ready**: Modern Python best practices, timezone-aware, Pydantic V2\n\n## \ud83d\udce6 Installation\n\n### From PyPI (Recommended)\n\nThe fastest and easiest way to use MCP Package Hero is directly from PyPI:\n\n```bash\n# No installation needed! Just use uvx to run it directly\nuvx mcp-package-hero\n\n# Or install it as a tool for repeated use\nuv tool install mcp-package-hero\n```\n\n### From Source (Development)\n\nFor development or contributing:\n\n```bash\n# Install uv if you haven't already\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Clone the repository\ngit clone https://github.com/moinsen-dev/mcp-package-hero.git\ncd mcp-package-hero\n\n# Install dependencies\nuv sync\n\n# Install the package in editable mode\nuv pip install -e .\n```\n\n## \ud83d\udd27 Configuration\n\nAdd to your MCP client configuration (e.g., Claude Desktop, Cline, etc.):\n\n### Claude Desktop\n\n#### Option 1: From PyPI (Recommended - Fast!)\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n \"mcpServers\": {\n \"package-hero\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-package-hero\"]\n }\n }\n}\n```\n\n**Startup time**: ~1-2 seconds (first run), ~0.5 seconds (cached) \u26a1\n\n#### Option 2: From GitHub (Slower)\n\n```json\n{\n \"mcpServers\": {\n \"package-hero\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\",\n \"git+https://github.com/moinsen-dev/mcp-package-hero.git\",\n \"mcp-package-hero\"\n ]\n }\n }\n}\n```\n\n#### Option 3: From local directory (Development)\n\n```json\n{\n \"mcpServers\": {\n \"package-hero\": {\n \"command\": \"uv\",\n \"args\": [\n \"run\",\n \"--directory\",\n \"/path/to/mcp-package-hero\",\n \"mcp-package-hero\"\n ]\n }\n }\n}\n```\n\n### Cline VSCode Extension\n\nEdit `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:\n\n#### Option 1: From PyPI (Recommended - Fast!)\n\n```json\n{\n \"mcpServers\": {\n \"package-hero\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-package-hero\"]\n }\n }\n}\n```\n\n#### Option 2: From GitHub (Slower)\n\n```json\n{\n \"mcpServers\": {\n \"package-hero\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\",\n \"git+https://github.com/moinsen-dev/mcp-package-hero.git\",\n \"mcp-package-hero\"\n ]\n }\n }\n}\n```\n\n#### Option 3: From local directory (Development)\n\n```json\n{\n \"mcpServers\": {\n \"package-hero\": {\n \"command\": \"uv\",\n \"args\": [\n \"run\",\n \"--directory\",\n \"/path/to/mcp-package-hero\",\n \"mcp-package-hero\"\n ]\n }\n }\n}\n```\n\n### Claude Code\n\nAdd the server globally to Claude Code using the CLI:\n\n#### Option 1: From PyPI (Recommended - Fast!)\n\n```bash\nclaude mcp add-json package-hero '{\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-package-hero\"]}'\n```\n\n#### Option 2: From GitHub (Slower)\n\n```bash\nclaude mcp add-json package-hero '{\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"git+https://github.com/moinsen-dev/mcp-package-hero.git\",\"mcp-package-hero\"]}'\n```\n\n#### Option 3: From local directory (Development)\n\n```bash\nclaude mcp add-json package-hero '{\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"run\",\"--directory\",\"/path/to/mcp-package-hero\",\"mcp-package-hero\"]}'\n```\n\n## \ud83d\udcd6 Usage\n\n### Tool 1: Get Latest Version\n\nCheck the latest version of a single package:\n\n```python\n# Example queries for your LLM:\n\"What's the latest version of requests in Python?\"\n\"Check the current version of react\"\n\"Show me the latest version of the http package for Dart\"\n\"What's the latest version of serde in Rust?\"\n```\n\n**Tool Name**: `get_latest_version`\n\n**Parameters**:\n- `package_name` (string): Name of the package\n- `ecosystem` (string): One of \"python\", \"javascript\", \"dart\", or \"rust\"\n\n**Example Response**:\n```json\n{\n \"package_name\": \"requests\",\n \"ecosystem\": \"python\",\n \"latest_version\": \"2.31.0\",\n \"registry_url\": \"https://pypi.org/project/requests/\",\n \"checked_at\": \"2025-10-06T10:30:00Z\",\n \"status\": \"success\"\n}\n```\n\n### Tool 2: Batch Version Check\n\nCheck multiple packages at once (max 10):\n\n```python\n# Example query:\n\"Check the latest versions of requests (python), react (javascript), http (dart), and serde (rust)\"\n```\n\n**Tool Name**: `get_latest_versions_batch`\n\n**Parameters**:\n- `packages` (array): List of objects with `package_name` and `ecosystem`\n- `max_packages` (integer, optional): Limit (default: 10)\n\n**Example Response**:\n```json\n{\n \"results\": [\n {\n \"package_name\": \"requests\",\n \"ecosystem\": \"python\",\n \"latest_version\": \"2.31.0\",\n \"status\": \"success\"\n },\n {\n \"package_name\": \"nonexistent-pkg\",\n \"ecosystem\": \"python\",\n \"latest_version\": null,\n \"status\": \"not_found\"\n }\n ],\n \"checked_at\": \"2025-10-06T10:30:00Z\"\n}\n```\n\n### Tool 3: Rate Package Quality (v1.1.0+)\n\nGet comprehensive quality rating for a package:\n\n```python\n# Example queries:\n\"Rate the quality of the requests package\"\n\"How good is the react package?\"\n\"Give me a quality assessment of flutter_bloc\"\n\"How does the serde crate rate?\"\n```\n\n**Tool Name**: `rate_package`\n\n**Parameters**:\n- `package_name` (string): Name of the package\n- `ecosystem` (string): One of \"python\", \"javascript\", \"dart\", or \"rust\"\n\n**Example Response**:\n```json\n{\n \"package_name\": \"requests\",\n \"ecosystem\": \"python\",\n \"overall_score\": 86.6,\n \"letter_grade\": \"A-\",\n \"maintenance\": {\n \"score\": 78.8,\n \"last_release_days\": 48,\n \"release_frequency_score\": 80.0,\n \"issue_resolution_score\": 100.0,\n \"pr_merge_score\": 44.2\n },\n \"popularity\": {\n \"score\": 100.0,\n \"downloads\": 855587647,\n \"stars\": 53340,\n \"downloads_score\": 100.0,\n \"stars_score\": 100.0\n },\n \"quality\": {\n \"score\": 85.0,\n \"has_documentation\": true,\n \"has_license\": true,\n \"has_tests\": null,\n \"documentation_score\": 100.0,\n \"license_score\": 100.0,\n \"test_score\": 50.0\n },\n \"repository_url\": \"https://github.com/psf/requests\",\n \"license\": \"Apache-2.0\",\n \"description\": \"Python HTTP for Humans.\",\n \"insights\": [\n \"Strong issue resolution track record\",\n \"Highly popular with 100K+ monthly downloads\",\n \"Well-starred project (1000+ stars)\",\n \"High quality package with good documentation and license\"\n ],\n \"red_flags\": [],\n \"status\": \"success\"\n}\n```\n\n### Tool 4: Get llms.txt (v1.2.0+)\n\nFetch llms.txt documentation file for a package:\n\n```python\n# Example queries:\n\"Get the llms.txt file for fasthtml\"\n\"Show me the documentation structure for react\"\n\"Fetch llms.txt and llms-full.txt for flutter_bloc\"\n\"Get the llms.txt for tokio\"\n```\n\n**Tool Name**: `get_llms_txt`\n\n**Parameters**:\n- `package_name` (string): Name of the package\n- `ecosystem` (string): One of \"python\", \"javascript\", \"dart\", or \"rust\"\n- `include_full` (boolean, optional): Also fetch llms-full.txt (default: false)\n\n**Example Response**:\n```json\n{\n \"package_name\": \"fasthtml\",\n \"ecosystem\": \"python\",\n \"llms_txt_content\": {\n \"project_name\": \"FastHTML\",\n \"summary\": \"FastHTML is a python library which brings together Starlette, Uvicorn, HTMX, and fastcore's FT FastTags\",\n \"sections\": [\n {\n \"title\": \"Docs\",\n \"links\": [\n {\n \"title\": \"FastHTML quick start\",\n \"url\": \"https://fastht.ml/docs/tutorials/quickstart_for_web_devs.html.md\",\n \"description\": \"Overview of features\"\n }\n ]\n }\n ],\n \"raw_content\": \"# FastHTML\\n\\n> FastHTML is a python library...\",\n \"is_valid\": true,\n \"validation_warnings\": []\n },\n \"source_url\": \"https://raw.githubusercontent.com/AnswerDotAI/fasthtml/main/llms.txt\",\n \"source_type\": \"github_main\",\n \"repository_url\": \"https://github.com/AnswerDotAI/fasthtml\",\n \"status\": \"success\"\n}\n```\n\n### Tool 5: Create llms.txt (v1.2.0+)\n\nGenerate an llms.txt file for your project:\n\n```python\n# Example queries:\n\"Create an llms.txt file for my project called 'My Library'\"\n\"Generate llms.txt documentation for this codebase\"\n\"Create llms.txt with only documentation and examples sections\"\n```\n\n**Tool Name**: `create_llms_txt`\n\n**Parameters**:\n- `project_name` (string): Name of your project\n- `description` (string): Brief project description\n- `scan_directory` (string, optional): Directory to scan (default: \".\")\n- `sections` (list, optional): Specific sections to include (e.g., [\"documentation\", \"examples\"])\n\n**Available Sections**: documentation, examples, api, guides, configuration\n\n**Example Response**:\n```json\n{\n \"content\": \"# My Project\\n\\n> A comprehensive Python library\\n\\n## Documentation\\n\\n- [README](README.md): Project overview and getting started\\n- [Contributing Guide](CONTRIBUTING.md): Guidelines for contributing\\n\\n## Examples\\n\\n- [Basic Example](examples/basic.py): Example code\\n\",\n \"discovered_files\": {\n \"documentation\": [\"README.md\", \"CONTRIBUTING.md\"],\n \"examples\": [\"examples/basic.py\"]\n },\n \"suggested_path\": \"./llms.txt\",\n \"status\": \"success\"\n}\n```\n\n## \ud83e\uddea Testing\n\nRun the test suite:\n\n```bash\n# Run all tests\nuv run pytest\n\n# Run with coverage\nuv run pytest --cov=src/mcp_package_hero --cov-report=html\n\n# Run with coverage summary\nuv run pytest --cov=src/mcp_package_hero --cov-report=term-missing\n\n# Run specific test file\nuv run pytest tests/test_registries/test_pypi.py\n```\n\n### Test Results\n- \u2705 68/68 tests passing\n- \u2705 Comprehensive coverage for version checking, rating, and llms.txt features\n- \u2705 All four ecosystems validated with live API calls\n\n## \ud83c\udfd7\ufe0f Development\n\n### Project Structure\n\n```\nmcp-package-hero/\n\u251c\u2500\u2500 src/mcp_package_hero/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 server.py # Main FastMCP server\n\u2502 \u251c\u2500\u2500 models.py # Pydantic models\n\u2502 \u251c\u2500\u2500 github_client.py # GitHub API client\n\u2502 \u251c\u2500\u2500 rating_calculator.py # Rating algorithms\n\u2502 \u251c\u2500\u2500 registries/ # Version checking\n\u2502 \u2502 \u251c\u2500\u2500 base.py\n\u2502 \u2502 \u251c\u2500\u2500 pypi.py\n\u2502 \u2502 \u251c\u2500\u2500 npm.py\n\u2502 \u2502 \u2514\u2500\u2500 pubdev.py\n\u2502 \u2514\u2500\u2500 raters/ # Quality rating\n\u2502 \u251c\u2500\u2500 python_rater.py\n\u2502 \u251c\u2500\u2500 javascript_rater.py\n\u2502 \u2514\u2500\u2500 dart_rater.py\n\u251c\u2500\u2500 tests/\n\u251c\u2500\u2500 README.md\n\u2514\u2500\u2500 pyproject.toml\n```\n\n### Code Quality\n\n```bash\n# Format code\nuv run ruff format .\n\n# Lint code\nuv run ruff check .\n\n# Auto-fix safe linting issues\nuv run ruff check --fix .\n\n# Type check\nuv run mypy src/\n```\n\n### Quality Standards\n- \u2705 **Type Safety**: Full mypy compliance with Pydantic plugin\n- \u2705 **Code Style**: Ruff linting and formatting\n- \u2705 **Modern Python**: Python 3.10+ type hints (PEP 604)\n- \u2705 **Timezone-Aware**: All timestamps use UTC timezone\n- \u2705 **Pydantic V2**: Using latest ConfigDict patterns\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## \ud83d\udcdd License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- Built with [FastMCP](https://github.com/jlowin/fastmcp) by Prefect\n- Inspired by [mcp-package-version](https://github.com/sammcj/mcp-package-version) by Sam McLeod\n- Part of the [Model Context Protocol](https://modelcontextprotocol.io) ecosystem\n\n## \ud83d\udcde Support\n\n- **Issues**: [GitHub Issues](https://github.com/moinsen-dev/mcp-package-hero/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/moinsen-dev/mcp-package-hero/discussions)\n\n## \ud83d\uddfa\ufe0f Roadmap\n\n### v1.2.0 \u2705 (Current)\n- [x] llms.txt support - fetch documentation from packages\n- [x] llms.txt generation - create documentation for projects\n- [x] Multi-source fetching (GitHub, homepages)\n- [x] Documentation validation and parsing\n\n### v1.1.0 \u2705\n- [x] Package quality rating system\n- [x] Multi-dimensional scoring (maintenance, popularity, quality)\n- [x] GitHub integration for repository metrics\n- [x] Integration with ecosystem-native scores (pub.dev, npms.io)\n\n### v1.3.0 \u2705\n- [x] Rust ecosystem support (crates.io)\n- [x] Full integration with existing tools (version checking, quality rating, llms.txt)\n- [x] Comprehensive test coverage for Rust packages\n\n### v1.4.0 (Planned)\n- [ ] Additional ecosystems (Go, Swift)\n- [ ] Cache layer for improved performance\n- [ ] Support for specific version queries\n\n### v2.0 (Future)\n- [ ] Dependency tree analysis\n- [ ] Version compatibility checking\n- [ ] Security vulnerability detection\n\n---\n\nMade with \u2615\ufe0f by [moinsen-dev](https://github.com/moinsen-dev)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for package version checking, quality rating, and llms.txt documentation across PyPI, npm, pub.dev, and crates.io",
"version": "1.3.0",
"project_urls": {
"Documentation": "https://github.com/moinsen-dev/mcp-package-hero/blob/main/README.md",
"Homepage": "https://github.com/moinsen-dev/mcp-package-hero",
"Issues": "https://github.com/moinsen-dev/mcp-package-hero/issues",
"Repository": "https://github.com/moinsen-dev/mcp-package-hero"
},
"split_keywords": [
"mcp",
" package",
" version",
" rating",
" quality",
" pypi",
" npm",
" pub.dev",
" fastmcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "758b6397c49f785913859f3ded3bb141340ba512001eca17ebe4f6d7e93d5f50",
"md5": "007bf33e80d0dafeee7f7f4ff50170e7",
"sha256": "b01f0876975d425cc73930c8f911944474be486a9eeb307c5f9bf165faf8ef9a"
},
"downloads": -1,
"filename": "mcp_package_hero-1.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "007bf33e80d0dafeee7f7f4ff50170e7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 41087,
"upload_time": "2025-10-23T11:25:30",
"upload_time_iso_8601": "2025-10-23T11:25:30.919353Z",
"url": "https://files.pythonhosted.org/packages/75/8b/6397c49f785913859f3ded3bb141340ba512001eca17ebe4f6d7e93d5f50/mcp_package_hero-1.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "63fc32919599a630b94a1ed32ba65c09d0923e8de323081dc949285243600de7",
"md5": "08aa76ea95a76622edd2ee03d6c3f0b9",
"sha256": "3efc329152f48057ca7f90ba64a7e3874397aba1fb356df3208feba4c502f84d"
},
"downloads": -1,
"filename": "mcp_package_hero-1.3.0.tar.gz",
"has_sig": false,
"md5_digest": "08aa76ea95a76622edd2ee03d6c3f0b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 26746,
"upload_time": "2025-10-23T11:25:31",
"upload_time_iso_8601": "2025-10-23T11:25:31.849388Z",
"url": "https://files.pythonhosted.org/packages/63/fc/32919599a630b94a1ed32ba65c09d0923e8de323081dc949285243600de7/mcp_package_hero-1.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-23 11:25:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "moinsen-dev",
"github_project": "mcp-package-hero",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mcp-package-hero"
}
JSON
