iflow-mcp_py_dep_man_companion 0.1.1

Local stdio MCP server providing unified search across Python dependency managers' latest and official documentation.

Python Dependency Manager Companion MCP Server

README updated on 2025-08-16 by @KemingHe

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

🚀 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"]
      }
    }
  }
}

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

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

🗺️ Roadmap

• Added support for pixi and pdm in version 0.1.1
• 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
│   │   ├── pixi/             # pixi docs
│   │   └── pdm/              # pdm 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.