🚀 Python依赖管理助手MCP服务器
本项目能避免你从人工智能获取到过时的Python包管理命令。它会自动更新并交叉引用最新的官方 pip、poetry、uv 和 conda 文档。[在YouTube上观看演示]
🚀 快速开始
适用于智能集成开发环境（Agentic IDEs）的快速开始步骤
- 拉取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
- 添加到你的IDE的
mcp.json文件中：
{
"mcp": {
"servers": {
"python-deps": {
"command": "docker",
"args": ["run", "-i", "--rm", "keminghe/py-dep-man-companion"]
}
}
}
}
- 提出包管理相关问题 - 例如 “如何将
conda项目迁移到uv？” 并获取准确的最新官方语法。
🤝 贡献代码
- 作为模板使用：[从模板创建] 用于你自己的MCP服务器项目。
- 贡献代码：复刻仓库并遵循 CONTRIBUTING.md 进行开发环境的设置。
🔄 自动更新架构
- ⏰ 美国东部时间每周二下午6点
- 📚 同步官方文档
- 🔍 重建搜索索引
- 🐳 发布最新镜像
🗺️ 路线图
- [ ] 增加对
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问题 中提出。