【技术文档摘要】：

<div align="center">

🎯 GitHub Kanban MCP Server

<img src="https://raw.githubusercontent.com/Sunwood-ai-labs/github-kanban-mcp-server/main/assets/header.svg" alt="GitHub Kanban MCP Server" width="100%" />

</div>

📋 概要

GitHub Kanban MCP Server 是一个 Model Context Protocol（MCP）服务器，用于以看板形式管理 GitHub 的问题，并通过 LLM 来提高任务管理效率。

🚀 特征

• 🔄 以看板形式管理 GitHub 的问题
• 🤖 通过 LLM 进行自动任务管理
• 📊 可视化项目进度
• 🔗 完全集成 GitHub
• 💬 任务评论功能

📁 项目结构

kanban-server/
├── src/                    # 源代码目录
│   ├── handlers/          # 请求处理器
│   │   ├── comment-handlers.ts  # 评论相关处理
│   │   ├── issue-handlers.ts    # 问题相关处理
│   │   ├── label-handlers.ts    # 标签相关处理
│   │   └── tool-handlers.ts     # 工具请求处理
│   ├── schemas/           # 输入模式定义
│   │   ├── comment-schemas.ts   # 评论相关模式
│   │   └── issue-schemas.ts     # 问题相关模式
│   ├── utils/             # 实用函数
│   │   ├── error-handler.ts     # 错误处理
│   │   └── exec.ts             # 命令执行相关
│   ├── server.ts          # MCP 服务器实现
│   └── types.ts           # 类型定义
├── docs/                  # 文档
│   └── v0.2.0/           # 版本特定文档
└── assets/               # 资产文件

🛠️ 安装

前提条件

• Node.js 18.x 或更高版本
• npm 9.x 或更高版本
• GitHub CLI (gh)

# 安装包
npm install @sunwood-ai-labs/github-kanban-mcp-server

# 配置 GitHub CLI 认证
gh auth login

⚙️ 配置

在 MCP 配置文件中添加以下内容:

{
  "mcpServers": {
    "github-kanban": {
      "command": "github-kanban-mcp-server"
    }
  }
}

🔧 可用工具

1. list_issues

获取看板中的问题列表。

输入参数:

• repo: GitHub 仓库名称（必需）
• state: 问题状态（'open', 'closed', 'all'）
• labels: 用于过滤的标签数组

2. create_issue

创建新的问题。

输入参数:

• repo: GitHub 仓库名称（必需）
• title: 问题标题（必需）
• emoji: 添加到标题开头的表情符号
• body: 问题正文
• labels: 标签数组
• assignees: 分配给用户的数组

3. update_issue

更新现有问题。

输入参数:

• repo: GitHub 仓库名称（必需）
• issue_number: 问题编号（必需）
• title: 新标题
• emoji: 添加到标题开头的表情符号
• body: 新正文
• state: 新状态（'open', 'closed'）
• labels: 新标签数组
• assignees: 新分配用户数组

4. add_comment

向任务添加评论。

输入参数:

• repo: GitHub 仓库名称（必需）
• issue_number: 任务（问题）ID（必需）
• body: 评论内容（支持 Markdown 格式）（必需）
• state: 在评论时更改的问题状态（'open', 'closed'）

📝 许可证

MIT 许可证 - 请参阅 LICENSE 文件。

🤝 贡献

1. 分叉此仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '✨ feat: 添加了令人惊叹的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建拉取请求

📮 反馈

如果您有任何问题或建议，请创建问题。