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問題 中提出。