Sunwood Ai Labs Github Kanban MCP Server

🚀 GitHub Collapsible Project Board MCP Server

The GitHub Collapsible Project Board MCP Server is a collapsible project board based on GitHub issues, designed to efficiently manage tasks for Large Language Models (LLMs) through the Model Context Protocol (MCP).

🚀 Quick Start

The GitHub Collapsible Project Board MCP Server is a powerful tool that transforms GitHub issues into a collapsible project board, enabling efficient task management for LLMs.

✨ Features

• 🔄 Convert GitHub issues into a collapsible project board for management.
• 🤖 Support automated task processing for LLMs.
• 📊 Visualize project progress.
• 🔗 Fully integrate into the GitHub ecosystem.
• 💬 Enable issue commenting functionality.

📦 Installation

1. Clone the repository:

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

2. Install dependencies:

npm install

🛎️ Configuration

Create a config.ts file as follows:

export interface Config {
  port: number;
  environment: 'development' | 'production' | 'testing';
  logLevel: 'debug' | 'info' | 'warn' | 'error';
}

const config: Config = {
  port: 3000,
  environment: 'development',
  logLevel: 'debug'
};

export default config;

🚀 Start the Server

npm start

💻 Usage Examples

Create a Project Board

Create a new project board:

npx kanban create my-board
cd my-board
npm install

Start the project board service:

npm run dev

Visit http://localhost:3000 to view your project board.

📚 Documentation

Refer to the official documentation for the complete API documentation and usage guide.

📈 Efficiency Improvement

By converting GitHub issues into a collapsible project board, you can:

• Manage tasks more intuitively.
• Improve team collaboration efficiency.
• Track project progress easily.
• Save time through automated processes.

💡 Key Features

• Support Markdown-formatted comments and descriptions.
• Provide flexible task status classification.
• Offer an extensible field system for adding custom attributes.
• Include built-in search and filtering functions.
• Be fully open-source and customizable.

🤝 Contribution Guidelines

1. Clone the repository

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

2. Create a feature branch

   git checkout -b feature/amazing-feature
   

3. Commit your changes

   git add .
   git commit -m '✨ Add an amazing feature'
   git push origin feature/amazing-feature
   

4. Submit a pull request

📮 Feedback

If you encounter any issues or have suggestions for improvement, please submit them on GitHub Issues.

📦 Project Structure

kanban-server/
├── src/                    # Source code directory
│   ├── handlers/          # Request handlers
│   │   ├── comment-handlers.ts  # Comment-related processing logic
│   │   ├── issue-handlers.ts    # Issue-related processing logic
│   │   ├── label-handlers.ts    # Label-related processing logic
│   │   └── tool-handlers.ts     # Tool request processing logic
│   ├── schemas/           # Data structure definitions
│   │   └── index.ts      # Unified export of data structures
│   ├── types/            # Type definitions
│   │   └── index.ts      # Unified export of types
│   ├── routes/           # API route definitions
│   │   └── index.ts      # Unified export of routes
│   ├── app.ts            # Application entry point
│   └── index.ts          # Program startup point
├── package.json          # Project dependency management file
└── tsconfig.json         # TypeScript configuration file

📄 License

This project is licensed under the MIT License.