Python Dependency Manager Companion MCP Server
README updated on 2025-07-23 by @KemingHe
Official docs from pip , poetry , uv , and conda + automated weekly updates = zero maintenance overhead for developers using VSCode/Cursor with AI assistants. [Demo]
π Quick Start for Agentic IDEs
1. Pull latest Docker image:
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. Query official docs directly in your AI chat - guaranteed fresh from weekly automated updates.
π€ 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
Zero maintenance: Documentation automatically synced weekly from official sources. Docker :latest tag guarantees you always get current docs without manual updates.
πΊοΈ Roadmap
Add support for pipenv , pdm , pixi
Add support for , , Add comprehensive tests with 100% coverage
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.