GitHub - KemingHe/python-dependency-manager-companion-mcp-server: Self-updating MCP server to cross-reference latest official pip, poetry, uv, and conda docs

https://github.com/KemingHe/python-dependency-manager-companion-mcp-server • Jul 25, 2025 19:24

Extracto

Self-updating MCP server to cross-reference latest official pip, poetry, uv, and conda docs - KemingHe/python-dependency-manager-companion-mcp-server

Resumen

Resumen Principal

El "Python Dependency Manager Companion MCP Server" es una herramienta altamente especializada y esencial diseñada para mitigar el desafío de la información desactualizada sobre comandos de gestores de paquetes Python, una problemática frecuente al interactuar con inteligencias artificiales. Este servidor MCP (Multi-Container Protocol) se distingue por su capacidad de proporcionar la sintaxis oficial más reciente y precisa para pip, poetry, uv y conda, actuando como una fuente autorizada. Su arquitectura está orientada a la integración en IDEs agenticos, garantizando que los desarrolladores accedan a datos verificados y actuales. Mediante un sofisticado sistema de autoactualización semanal, el Companion sincroniza la documentación oficial, reconstruye su índice de búsqueda y publica una nueva imagen Docker, asegurando una confiabilidad sin precedentes. Esto transforma la interacción con las herramientas de gestión de dependencias Python, ofreciendo una solución robusta y dinámica para mantener los proyectos alineados con las prácticas y comandos más recientes.

Elementos Clave

Solución a la Desactualización de Comandos: El proyecto aborda directamente el problema de los comandos obsoletos de gestores de paquetes Python, que a menudo provienen de fuentes no verificadas como algunas IAs. Se enfoca en proporcionar la sintaxis oficial y más reciente para los gestores pip, poetry, uv y conda, actuando como

Contenido

Python Dependency Manager Companion MCP Server

README updated on 2025-07-23 by @KemingHe

Stop getting out-of-date Python package manager commands from your AI. Cross-reference latest official pip, poetry, uv, and conda docs with auto-updates. [Demo]

🚀 Quick Start for Agentic IDEs

1. Pull Docker image:

# Pin to commit hash for production security
# Get current hash from: https://hub.docker.com/r/keminghe/py-dep-man-companion/tags
docker pull keminghe/py-dep-man-companion@sha256:2c896dc617e8cd3b1a1956580322b0f0c80d5b6dfd09743d90859d2ef2b71ec6  # 2025-07-22 release example

# Or use latest for development
docker pull keminghe/py-dep-man-companion:latest

2. Add to your IDE's mcp.json:

{
  "mcp": {
    "servers": {
      "python-deps": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "keminghe/py-dep-man-companion:latest"]
      }
    }
  }
}

3. Ask package manager questions - "How to migrate a conda project to uv?" and get accurate, current official syntax.

🤝 Contributing

Use as template: [Create from template] for your own MCP server projects.

Contribute back: Fork and follow CONTRIBUTING.md for development setup.

🔄 Auto-Update Architecture

graph LR
    WEEKLY["⏰ Every Tuesday 06:00pm ET"]
    DOCS["📚 Sync Official Docs"]
    INDEX["🔍 Rebuild Search Index"]
    DOCKER["🐳 Publish Latest Image"]
    
    WEEKLY --> DOCS
    DOCS --> INDEX
    INDEX --> DOCKER

Loading

🗺️ Roadmap

Add support for pipenv, pdm, pixi
Add comprehensive tests with 100% coverage
Add indexing support for PDF and CSV files

📁 Project Structure

python-dependency-manager-companion-mcp-server/
├── .github/workflows/            # Automation workflows
│   ├── auto-update-docs.yml      # Weekly docs update
│   ├── auto-update-index.yml     # Search index rebuild
│   ├── auto-update-publish.yml   # Multi-arch Docker publish
│   ├── auto-update.yml           # Combined automation
│   └── README.md                 # Workflow documentation
├── src/
│   ├── assets/               # Documentation source files
│   │   ├── conda/            # conda docs  
│   │   ├── pip/              # pip docs
│   │   ├── poetry/           # poetry docs
│   │   └── uv/               # uv docs
│   ├── index/                # Pre-built search index
│   ├── build_index.py        # Tantivy index builder
│   └── mcp_server.py         # FastMCP stdio server
├── Dockerfile                # Container build configuration
├── pyproject.toml            # Project dependencies and metadata
└── uv.lock                   # Locked dependencies

📄 License

This project is licensed under the MIT License - a permissive license that allows free use, modification, and distribution with attribution.

📞 Support

Open a GitHub issue for bug reports and feature requests.