Project Hub MCP Server

🚀 項目中心

項目中心是一款集成化開發環境工具，它整合了代碼倉庫初始化、版本控制、文件快照、分支管理及知識庫等功能，能有效提升軟件項目的管理效率。

🚀 快速開始

項目中心功能豐富，可通過簡單安裝後快速投入使用，為項目管理帶來便利。

✨ 主要特性

• 功能集成：整合代碼倉庫初始化、版本控制操作、文件快照、分支管理以及知識庫等功能模塊，提供一站式項目管理體驗。
• 操作便捷：提供多種操作命令，方便用戶進行本地倉庫初始化、提交管理、分支管理等操作。
• 數據記錄：在每次提交時自動捕獲文件的元數據信息，還支持歷史版本對比，便於追溯代碼變更。
• 知識管理：具備知識庫管理功能，支持創建筆記和按標籤、類別或內容關鍵字進行檢索。

📦 安裝指南

方式一：使用npm安裝

使用以下命令進行安裝：

npm install project-hub --save-dev

方式二：手動下載

訪問項目官網下載對應平臺的壓縮包，並解壓到指定目錄。

💻 使用示例

基礎用法

初始化本地倉庫

project-hub init-local-repository --projectId=my-project

創建提交

project-hub create-commit --projectId=my-project --message="feat: 添加新特性" --author=JohnDoe

高級用法

本地倉庫初始化

通過init_local_repository命令，可在指定項目目錄下初始化新的Git倉庫：

project-hub init-local-repository --projectId=project-123

提交管理

支持創建、查看和撤銷提交操作，示例如下：

• 創建新提交：create_commit
• 恢復到歷史提交：restore_to_local_commit
• 克隆倉庫至新位置：restore_local_branch_to_new_location

分支管理

提供完整的分支生命週期管理功能，包括創建、切換、刪除和同步等操作。

📚 詳細文檔

知識庫管理

• 創建筆記：記錄開發過程中的重要決策和經驗教訓。
• 搜索功能：支持按標籤、類別或內容關鍵字進行檢索。

文件快照

• 在每次提交時自動捕獲文件的元數據信息，包括大小、創建時間和修改時間等。
• 提供歷史版本對比功能，便於追溯代碼變更。

開發指南

1. 為項目功能模塊添加新特性。
2. 執行單元測試：

npm test

3. 構建發佈包：

npm run build

最近改進

本地Git功能（2024年3月）

• 實現了完整的本地Git操作，包括提交、分支和文件快照。
• 增加了恢復功能以回溯到之前的狀態。
• 支持將指定分支克隆至新位置。
• 文件快照增加元數據記錄。

項目管理改進（2024年2月）

• 新增clone_repository工具，支持從GitHub倉庫克隆代碼庫到指定目錄。
• 實現scan_project_files功能，用於掃描和記錄項目文件結構。
• 優化項目搜索功能，實現不區分大小寫的模糊匹配。
• 增強文件追蹤能力，提升元數據記錄維度。

貢獻指南

1. Fork本倉庫。
2. 創建功能分支。
3. 提交修改內容。
4. 推送到分支。
5. 提交Pull Request。

📄 許可證

本項目遵循MIT協議。