README-dockerhub.md

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.

🔄 Auto-Update Architecture

1. ⏰ Every Tuesday 6pm ET
2. 📚 Sync Official Docs
3. 🔍 Rebuild Search Index
4. 🐳 Publish Latest Image

🤝 Contributing

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

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

🗺️ Roadmap

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

📄 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.