Python Dependency Manager Companion MCP Server

🚀 Python依赖管理助手MCP服务器

本项目能避免你从人工智能获取到过时的Python包管理命令。它会自动更新并交叉引用最新的官方 pip、poetry、uv 和 conda 文档。[在YouTube上观看演示]

🚀 快速开始

适用于智能集成开发环境（Agentic IDEs）的快速开始步骤

1. 拉取Docker镜像：

# 为保证生产环境的安全性，使用提交哈希进行固定
# 从以下链接获取当前哈希值：https://hub.docker.com/r/keminghe/py-dep-man-companion/tags
docker pull keminghe/py-dep-man-companion@sha256:2c896dc617e8cd3b1a1956580322b0f0c80d5b6dfd09743d90859d2ef2b71ec6  # 2025-07-22 版本示例

# 或者在开发环境中使用最新版本
docker pull keminghe/py-dep-man-companion:latest

2. 添加到你的IDE的 mcp.json 文件中：

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

3. 提出包管理相关问题 - 例如 “如何将 conda 项目迁移到 uv？” 并获取准确的最新官方语法。

🤝 贡献代码

• 作为模板使用：[从模板创建] 用于你自己的MCP服务器项目。
• 贡献代码：复刻仓库并遵循 CONTRIBUTING.md 进行开发环境的设置。

🔄 自动更新架构

1. ⏰ 美国东部时间每周二下午6点
2. 📚 同步官方文档
3. 🔍 重建搜索索引
4. 🐳 发布最新镜像

🗺️ 路线图

• [ ] 增加对 pipenv、pdm、pixi 的支持
• [ ] 添加全面的测试，实现100%覆盖
• [ ] 增加对PDF和CSV文件的索引支持

📁 项目结构

python-dependency-manager-companion-mcp-server/
├── .github/workflows/            # 自动化工作流
│   ├── auto-update-docs.yml      # 每周文档更新
│   ├── auto-update-index.yml     # 搜索索引重建
│   ├── auto-update-publish.yml   # 多架构Docker发布
│   ├── auto-update.yml           # 组合自动化
│   └── README.md                 # 工作流文档
├── src/
│   ├── assets/               # 文档源文件
│   │   ├── conda/            # conda文档  
│   │   ├── pip/              # pip文档
│   │   ├── poetry/           # poetry文档
│   │   └── uv/               # uv文档
│   ├── index/                # 预构建的搜索索引
│   ├── build_index.py        # Tantivy索引构建器
│   └── mcp_server.py         # FastMCP标准输入输出服务器
├── Dockerfile                # 容器构建配置
├── pyproject.toml            # 项目依赖和元数据
└── uv.lock                   # 锁定的依赖

📄 许可证

本项目采用 MIT许可证 进行许可，这是一种宽松的许可证，允许在保留归属权的前提下自由使用、修改和分发。

📞 支持

如果你发现了bug或有功能请求，请在 GitHub问题 中提出。