libraries-io-mcp-server by ThatsRight-ItsTJ - MCP Server

Libraries.io MCP Server

A comprehensive Model Context Protocol (MCP) server that provides AI assistants with seamless access to Libraries.io's vast database of 9.96M+ open source packages across 33+ package managers including NPM, PyPI, Maven, Go, NuGet, and more.

🚀 Overview

The Libraries.io MCP Server transforms how AI assistants interact with open source ecosystems by providing:

Package Discovery: Search, filter, and discover packages across multiple platforms
Deep Analysis: Comprehensive dependency analysis, security checks, and license compatibility
Ecosystem Insights: Platform statistics, trending packages, and alternative recommendations
Project Management: Dependency auditing, update tracking, and comprehensive reporting
Real-time Data: Access to current package information, versions, and dependencies

✨ Features

🔍 Package Discovery & Search

Search packages by keywords, languages, licenses, and platforms
Discover trending and popular packages
Filter results by specific criteria
Compare multiple packages side-by-side

📊 Package Analysis

Detailed package information and metadata
Complete version history and release tracking
Dependency tree analysis with configurable depth
Security vulnerability assessments
License compatibility checking

🌍 Ecosystem Analysis

Platform-specific statistics and insights
Alternative package recommendations
Dependency impact analysis
Package ecosystem health scoring

🛠️ Project Management

Comprehensive dependency auditing
Update monitoring and tracking
Security-focused dependency reports
Project health scoring and recommendations

📋 Installation

Prerequisites

Python 3.8 or higher
A Libraries.io API key (Get your API key here)
An MCP-compatible client (Claude Desktop, etc.)

Quick Installation

# Clone the repository
git clone https://github.com/librariesio/libraries-io-mcp-server.git
cd libraries-io-mcp-server

# Install dependencies
pip install -r requirements.txt

# Or using uv (recommended)
uv sync

Development Installation

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/
isort src/

# Lint code
flake8 src/

⚙️ Configuration

Environment Setup

Copy the example environment file:

cp .env.example .env

Edit the .env file with your configuration:

# Required: Your Libraries.io API key
LIBRARIES_IO_API_KEY=your_api_key_here

# Optional: Base URL for the Libraries.io API (default: https://libraries.io/api)
LIBRARIES_IO_BASE_URL=https://libraries.io/api

# Optional: Rate limiting configuration
RATE_LIMIT_REQUESTS=60
RATE_LIMIT_WINDOW=60

# Optional: Logging level
LOG_LEVEL=INFO

API Key Setup

Visit Libraries.io API
Sign up for an account if you don't have one
Generate an API key
Add it to your environment variables or .env file

🚀 Usage

With Claude Desktop

Configure Claude Desktop with the provided configuration files:
- for basic setup
- for advanced configuration
Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "libraries-io": {
      "command": "uv",
      "args": [
        "run",
        "fastmcp",
        "run",
        "src/libraries_io_mcp/server.py"
      ],
      "env": {
        "LIBRARIES_IO_API_KEY": "your_api_key_here"
      }
    }
  }
}

With Docker

# Build and run with Docker Compose
docker-compose up --build

# Or run directly with Docker
docker run -d \
  --name libraries-io-mcp-server \
  -p 8000:8000 \
  -e LIBRARIES_IO_API_KEY=your_api_key_here \
  libraries-io-mcp-server

Direct Server Usage

# Start the server
python -m src.libraries_io_mcp.server

# Or using uv
uv run fastmcp run src/libraries_io_mcp/server.py

🛠️ Available Tools

Package Discovery

- Search packages by keyword, language, or license
- Get trending packages by platform
- Get most popular packages

Package Analysis

- Get detailed package information
- List all versions of a package
- Get package dependencies
- Get packages that depend on this one
- Compare multiple packages
- Check for security issues

Ecosystem Analysis

- Deep dependency analysis
- Find alternative packages
- Get statistics for a package manager
- Check license compatibility

Project Management

- Monitor package for updates
- Generate comprehensive dependency report
- Audit all dependencies in a project

📚 Documentation

Core Documentation

- Complete API documentation for all tools and resources
- Multiple deployment options and configurations
- Contributing guidelines and development setup

Integration Guides

- Step-by-step Claude Desktop setup
- Container deployment and scaling
- Usage examples and sample workflows

Additional Resources

- System architecture and design patterns
- Testing procedures and best practices
- Security best practices and reporting
- Version history and updates

🔧 Development

Project Structure

libraries-io-mcp-server/
├── src/
│   └── libraries_io_mcp/
│       ├── __init__.py
│       ├── server.py           # Main FastMCP server
│       ├── client.py           # Libraries.io API client
│       ├── models.py           # Pydantic data models
│       ├── tools.py            # MCP tools implementation
│       ├── resources.py        # MCP resources implementation
│       ├── prompts.py          # MCP prompts implementation
│       └── utils.py            # Utility functions
├── tests/
│   ├── unit/                   # Unit tests
│   ├── integration/            # Integration tests
│   └── fixtures/               # Test fixtures
├── docs/                       # Documentation
├── examples/                   # Usage examples
├── .env.example               # Environment template
├── pyproject.toml             # Project configuration
└── requirements.txt           # Dependencies

Setting Up Development Environment

# Clone the repository
git clone https://github.com/librariesio/libraries-io-mcp-server.git
cd libraries-io-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

# Set up environment variables
cp .env.example .env
# Edit .env with your API key

# Run tests
pytest

# Run with coverage
pytest --cov=src/libraries_io_mcp

# Format code
black src/
isort src/

# Lint code
flake8 src/
mypy src/

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=src/libraries_io_mcp --cov-report=html

# Run specific test categories
pytest tests/unit/
pytest tests/integration/

# Run tests in parallel
pytest -n auto

🏗️ Architecture

The Libraries.io MCP Server is built with a modular architecture:

FastMCP Server: Core MCP protocol implementation
Libraries.io Client: HTTP client with caching and rate limiting
Tools: MCP tools for package discovery and analysis
Resources: MCP resources for contextual data access
Prompts: AI interaction templates and workflows
Models: Pydantic data models for validation and serialization

📊 Performance & Scaling

Built-in Optimizations

Intelligent Caching: Reduces API calls and improves response times
Rate Limiting: Respects Libraries.io API limits and prevents abuse
Async Operations: Concurrent request processing for better performance
Request Deduplication: Eliminates duplicate API calls

Scaling Strategies

Horizontal Scaling: Multiple server instances behind a load balancer
Caching Layer: Redis integration for distributed caching
Load Balancing: Nginx or cloud load balancers
Container Orchestration: Kubernetes for automated scaling

🔒 Security

Security Features

API Key Management: Secure storage and rotation
Input Validation: Comprehensive parameter validation
Rate Limiting: Prevents abuse and ensures fair usage
Error Handling: Graceful degradation and secure error messages

Security Best Practices

Never commit API keys to version control
Use environment variables for sensitive information
Implement proper access controls
Regular security audits and updates

See for detailed security information.

🤝 Contributing

We welcome contributions! Please see our for:

Development setup and workflow
Code style and quality standards
Testing procedures
Pull request process
Issue reporting

Quick Contribution Steps

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and add tests
Run the test suite: pytest
Format your code: black src/ && isort src/
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

📈 Monitoring & Observability

Logging

Structured logging with correlation IDs
Configurable log levels (DEBUG, INFO, WARNING, ERROR)
Request/response logging for debugging

Metrics

API usage statistics
Response time monitoring
Cache hit rates
Error rate tracking

Health Checks

API connectivity monitoring
Cache health checks
Memory usage tracking
Service availability monitoring

🐛 Troubleshooting

Common Issues

API Key Issues
- Verify your API key is valid and has sufficient permissions
- Check that the environment variable is set correctly
- Ensure you haven't exceeded rate limits
Connection Problems
- Check network connectivity to Libraries.io API
- Verify firewall settings
- Check proxy configurations if applicable
Performance Issues
- Monitor API usage and rate limits
- Check cache hit rates
- Review server logs for errors

Getting Help

Check the
Review GitHub Issues
Create a new issue with detailed information

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

Libraries.io for providing the comprehensive open source package database
FastMCP for the excellent MCP framework
Pydantic for data validation and serialization
httpx for async HTTP client functionality

📞 Support

For support and questions:

🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions
📖 Documentation: Full Documentation