Local Pm

🚀 Local PM

Local PM 是一款輕量級的自託管項目管理工具，內置 MCP（模型上下文協議）服務器，可讓 AI 助手直接管理你的項目、工單和團隊。

✨ 主要特性

• 看板管理：支持通過拖放操作管理工單，包含待辦、進行中、已完成三列。
• 項目管理：可通過自定義項目（圖標、顏色、前綴）來組織工作。
• 團隊協作：可將工單分配給團隊，便於更好地組織工作。
• 工單功能：功能完備的工單系統，具備以下特性：
  • 優先級（緊急、高、中、低）
  • 截止日期
  • 帶顏色的自定義標籤
  • 支持完成狀態跟蹤的子任務
  • 工單依賴關係（被阻塞）
  • 富文本描述
• MCP 服務器：通過模型上下文協議實現原生 AI 項目管理。
• 自託管：數據存儲在本地機器。
• 支持 Docker：可通過一條命令完成部署。

📦 安裝指南

使用 Docker（推薦）

1. 克隆倉庫：

git clone https://github.com/your-username/local-pm.git
cd local-pm

2. 啟動容器：

docker-compose up -d

3. 在瀏覽器中訪問 http://localhost:3010 打開應用。

手動安裝

1. 克隆倉庫並安裝依賴：

git clone https://github.com/your-username/local-pm.git
cd local-pm
npm install

2. 設置環境變量：

cp .env.example .env
# 編輯 .env 文件，配置 MongoDB 連接字符串

3. 啟動開發服務器：

npm run dev

💻 使用示例

MCP 服務器設置

MCP（模型上下文協議）服務器允許像 Claude 這樣的 AI 助手直接與你的項目管理數據進行交互。

構建 MCP 服務器

cd mcp-server
npm install
npm run build

添加到 Claude 代碼（全局）

claude mcp add --scope user local-pm node "/path/to/local-pm/mcp-server/dist/index.js"

添加到 Claude 桌面版

在你的 Claude 桌面版配置文件（~/.claude/claude_desktop_config.json）中添加以下內容：

{
  "mcpServers": {
    "local-pm": {
      "command": "node",
      "args": ["/path/to/local-pm/mcp-server/dist/index.js"],
      "env": {
        "LOCAL_PM_URL": "http://localhost:3010"
      }
    }
  }
}

MCP 工具參考

MCP 服務器提供了 18 個工具用於完整的項目管理：

項目工具

團隊工具

工單工具

看板和子任務工具

MCP 如何增強 AI 開發

什麼是 MCP？

模型上下文協議（MCP）是一個開放標準，它使 AI 助手能夠與外部工具和數據源進行交互。AI 不僅可以進行聊天，還可以通過定義良好的工具接口在現實世界中採取行動。

對 AI 輔助開發的好處

1. 持久任務跟蹤
   • AI 可以為其正在實現的功能創建工單。
   • 跨編碼會話跟蹤進度。
   • 不會丟失已完成或待辦事項的上下文信息。
2. 結構化工作流程
   • AI 可以將複雜的功能分解為子任務。
   • 設置優先級和截止日期。
   • 管理工單之間的依賴關係。
3. 項目組織
   • AI 可以將工作組織成邏輯項目。
   • 將任務分配給團隊。
   • 清晰地掌握所有工作的概況。
4. 無縫集成
   • 直接在 AI 編碼工作流程中使用。
   • 無需切換到外部工具。
   • AI 在工作時可以讀取和更新工單。

示例工作流程

你：“為我們的新認證系統創建一個項目”
AI：[創建項目 AUTH 並添加相關描述]
你：“將登錄功能分解為工單”
AI：[創建以下工單：
  - AUTH - 1：實現登錄表單 UI
  - AUTH - 2：創建認證 API 端點
  - AUTH - 3：添加 JWT 令牌處理
  - AUTH - 4：實現會話管理
  設置 AUTH - 2 阻塞 AUTH - 3 和 AUTH - 4]
你：“開始處理登錄表單”
AI：[將 AUTH - 1 移至進行中，實現該功能，完成後移至已完成]

為什麼選擇本地自託管？

• 隱私性：項目數據存儲在本地機器。
• 速度快：AI 工具調用無網絡延遲。
• 可定製：可根據需要進行定製和擴展。
• 離線使用：無需互聯網連接即可工作。

🔧 技術細節

• 前端：Next.js 15、React、Tailwind CSS
• 後端：Payload CMS 3.0
• 數據庫：MongoDB
• MCP 服務器：TypeScript、@modelcontextprotocol/sdk

📄 許可證

文檔未提及相關內容，暫不展示。

特別感謝

本項目基於 Payload CMS 構建。