elchika-inc/package-readme-core-mcp-server

Package README Core MCP Server

A Model Context Protocol (MCP) server that intelligently detects package managers and routes requests to appropriate package-specific MCP servers for unified package documentation access.

Features

• Smart Package Detection: Automatically detects the appropriate package manager from package names and context
• Unified Interface: Single API endpoint for accessing multiple package manager ecosystems
• Multi-Manager Support: Integrates with 15+ package manager-specific MCP servers
• Parallel Processing: Executes multiple package managers concurrently for optimal results
• Intelligent Routing: Routes requests to the most appropriate package manager server
• Fallback Mechanism: Provides alternative options when primary detection fails

MCP Client Configuration

Add this server to your MCP client configuration:

{
  "mcpServers": {
    "package-readme-core": {
      "command": "npx",
      "args": ["package-readme-core-mcp-server"]
    }
  }
}

Available Tools

smart_package_readme

Automatically detects the package manager and retrieves README content with intelligent routing.

Parameters:

• package_name (required): Name of the package to retrieve README for
• context_hints (optional): Array of context hints to help with detection
• version (optional): Specific version (default: latest)

Examples:

Basic README retrieval:

{
  "name": "smart_package_readme",
  "arguments": {
    "package_name": "express"
  }
}

With context hints:

{
  "name": "smart_package_readme",
  "arguments": {
    "package_name": "requests",
    "context_hints": ["python", "http"]
  }
}

smart_package_info

Automatically detects the package manager and retrieves detailed package information.

Parameters:

• package_name (required): Name of the package
• context_hints (optional): Array of context hints for better detection
• include_dependencies (optional): Include dependency information (default: true)

Example:

{
  "name": "smart_package_info",
  "arguments": {
    "package_name": "lodash",
    "context_hints": ["javascript"],
    "include_dependencies": true
  }
}

smart_package_search

Automatically detects relevant package managers and searches for packages across ecosystems.

Parameters:

• query (required): Search query string
• context_hints (optional): Array of context hints to focus search
• limit (optional): Maximum number of results (default: 20)

Example:

{
  "name": "smart_package_search",
  "arguments": {
    "query": "http client",
    "context_hints": ["python"],
    "limit": 10
  }
}

list_supported_managers

Lists all supported package managers and their current connection status.

Parameters: None required.

Example:

{
  "name": "list_supported_managers",
  "arguments": {}
}

Error Handling

Common error scenarios:

• Package manager detection failed
• No suitable package manager found
• All package manager servers unavailable
• Network connectivity issues
• Invalid package names or search queries
• MCP server connection timeouts

License

MIT