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 forcontext_hints (optional): Array of context hints to help with detectionversion (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 packagecontext_hints (optional): Array of context hints for better detectioninclude_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 stringcontext_hints (optional): Array of context hints to focus searchlimit (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
