Github Kanban MCP Server

🚀 GitHub 問題看板 MCP 服務器

GitHub 問題看板 MCP 服務器是一個基於 GitHub 問題的看板管理工具，結合大語言模型（LLM）實現任務自動化管理，能有效提升項目管理效率。

🚀 快速開始

GitHub 問題看板 MCP 服務器是一個結合了 GitHub 問題與大語言模型（LLM）的工具，可實現高效的任務自動化管理。以下是快速開始的步驟：

# 克隆倉庫
git clone https://github.com/sunwood-ai-labs/github-kanban-mcp-server.git
cd github-kanban-mcp-server

# 安裝依賴
npm install

# 啟動服務
npm start

✨ 主要特性

• 🔄 以看板形式管理 GitHub 問題，直觀展示任務狀態。
• 🤖 藉助 LLM 實現任務自動化處理，提高工作效率。
• 📊 可視化項目進展，方便跟蹤任務進度。
• 💡 支持評論交互，便於團隊成員溝通協作。
• 🔧 可靈活配置多狀態和標籤，滿足不同項目需求。

📦 安裝指南

1. 確保已安裝 Node.js 和 npm，版本要求為 Node.js >=14，npm >=6。
2. 克隆倉庫：

   git clone https://github.com/sunwood-ai-labs/github-kanban-mcp-server.git
   cd github-kanban-mcp-server
   

3. 安裝依賴：

   npm install
   

4. 啟動服務：

   npm start
   

📚 詳細文檔

🎮 設置說明

在 config.json 中添加 MCP 服務器配置：

{
  "mcpServer": {
    "host": "localhost",
    "port": 3000,
    "githubToken": "your_github_token"
  }
}

🤝 可用工具

1. 列出問題

• 命令：list_issues
• 參數：
  • repo：目標倉庫名（必填）
  • state：過濾狀態（open/closed）（可選，默認：all）

2. 創建新問題

• 命令：create_issue
• 參數：
  • repo：倉庫名（必填）
  • title：問題標題（必填）
  • body：問題描述（可選）
  • labels：標籤列表（可選）

3. 更新現有問題

• 命令：update_issue
• 參數：
  • repo：倉庫名（必填）
  • issue_number：問題編號（必填）
  • title：新標題（可選）
  • body：新描述（可選）
  • state：新狀態（open/closed）（可選）
  • labels：新標籤列表（可選）

4. 添加評論

• 命令：add_comment
• 參數：
  • repo：倉庫名（必填）
  • issue_number：問題編號（必填）
  • body：評論內容（必填，支持 Markdown 格式）
  • state：更新狀態（open/closed）（可選）

🔧 技術細節

項目架構如下：

├── src/
│   ├── index.ts           # 入口文件
│   ├── server.ts          # 服務器核心邏輯
│   ├── services/
│       ├── githubService.ts      # GitHub API 調用處理
│       └── mcpService.ts        # MCP 協議接口實現
├── interfaces/
│   ├── issue.ts           # 問題接口定義
│   └── comment.ts         # 評論接口定義
└── package.json          # 項目依賴管理

📄 許可證

本項目採用 MIT 許可證。詳情請參見 LICENSE 文件。

🤑 貢獻指南

1. Fork 該項目倉庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m '✨ 新增: 簡單明瞭的功能描述')。
4. 推送到遠程分支 (git push origin feature/amazing-feature)。
5. 提交 Pull Request。

📬 反饋

如遇問題或有任何建議，請通過 Issues 提交。