{"id":29552584,"url":"https://github.com/fisapool/literate-guide","last_synced_at":"2025-07-18T05:11:11.724Z","repository":{"id":305010884,"uuid":"1021591138","full_name":"fisapool/literate-guide","owner":"fisapool","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-17T19:22:23.000Z","size":255,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-17T20:23:12.916Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fisapool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-17T16:21:22.000Z","updated_at":"2025-07-17T18:50:39.000Z","dependencies_parsed_at":"2025-07-17T23:07:41.139Z","dependency_job_id":null,"html_url":"https://github.com/fisapool/literate-guide","commit_stats":null,"previous_names":["fisapool/literate-guide"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/fisapool/literate-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fliterate-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fliterate-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fliterate-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fliterate-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fisapool","download_url":"https://codeload.github.com/fisapool/literate-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fliterate-guide/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265703757,"owners_count":23814073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-18T05:11:07.656Z","updated_at":"2025-07-18T05:11:11.708Z","avatar_url":"https://github.com/fisapool.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔄 Kanban MCP\n\nWelcome to the Kanban MCP project! 🎉 This project integrates Planka kanban boards with Cursor's Machine Control Protocol (MCP) to enable AI assistants like Claude to manage your kanban boards.\n\n## 🤔 What is Kanban MCP?\n\nKanban MCP is a bridge between [Planka](https://planka.app/) (an open-source kanban board) and [Cursor](https://cursor.sh/)'s Machine Control Protocol. It allows AI assistants like Claude to:\n\n- 📋 View and manage projects, boards, lists, and cards\n- ✅ Create and update tasks\n- 💬 Add comments to cards\n- 🔄 Move cards between lists\n- ⏱️ Track time spent on tasks\n- 🚀 And much more!\n\nThis integration enables a seamless workflow where you can ask Claude to help manage your development tasks, track progress, and organize your work.\n\n## 🚦 Quick Start\n\n### 📋 Prerequisites\n\n- 🐳 [Docker](https://www.docker.com/get-started) for running Planka\n- 🔄 [Git](https://git-scm.com/downloads) for cloning the repository\n- 🟢 [Node.js](https://nodejs.org/) (version 18 or above) and npm for development\n\n### 📥 Installation\n\n1. Clone this repository:\n```bash\ngit clone https://github.com/bradrisse/kanban-mcp.git\ncd kanban-mcp\n```\n\n2. Install dependencies and build the TypeScript code:\n```bash\nnpm install\nnpm run build\n```\n\n3. Start the Planka containers:\n```bash\nnpm run up\n```\n\n4. Access the Planka Kanban board:\n   - Default URL: http://localhost:3333\n   - Default credentials: \n     - Email: demo@demo.demo\n     - Password: demo\n\n5. Configure Cursor to use the MCP server:\n   - In Cursor, go to Settings \u003e Features \u003e MCP\n   - Add a new MCP server with the following configuration:\n   ```json\n   {\n     \"mcpServers\": {\n       \"kanban\": {\n         \"command\": \"node\",\n         \"args\": [\"/path/to/kanban-mcp/dist/index.js\"],\n         \"env\": {\n           \"PLANKA_BASE_URL\": \"http://localhost:3333\",\n           \"PLANKA_AGENT_EMAIL\": \"demo@demo.demo\",\n           \"PLANKA_AGENT_PASSWORD\": \"demo\"\n         }\n       }\n     }\n   }\n   ```\n   - Replace `/path/to/kanban-mcp` with the actual absolute path to your kanban-mcp directory\n\nAlternatively, you can use a project-specific configuration by creating a `.cursor/mcp.json` file in your project root with the same configuration.\n\nFor Docker-based deployment and other advanced options, see the [Installation Guide](https://github.com/bradrisse/kanban-mcp/wiki/Installation-Guide).\n\n## 📚 Documentation\n\n### For Users\n\n- [🛠️ Installation Guide](https://github.com/bradrisse/kanban-mcp/wiki/Installation-Guide): How to install and configure Kanban MCP\n- [📝 Usage Guide](https://github.com/bradrisse/kanban-mcp/wiki/Usage-Guide): How to use Kanban MCP with Claude\n- [💡 Capabilities and Strategies](https://github.com/bradrisse/kanban-mcp/wiki/Capabilities-and-Strategies): Detailed exploration of MCP server capabilities and LLM interaction strategies\n- [⚠️ Troubleshooting](https://github.com/bradrisse/kanban-mcp/wiki/Troubleshooting): Solutions to common issues\n\n### For Developers\n\n- [👨‍💻 Developer Guide](https://github.com/bradrisse/kanban-mcp/wiki/Developer-Guide): Information for developers who want to contribute to or modify Kanban MCP\n- [📖 API Reference](https://github.com/bradrisse/kanban-mcp/wiki/API-Reference): Detailed documentation of the MCP commands and Planka API integration\n\n## ✨ Features\n\nKanban MCP provides a comprehensive set of features for managing your kanban boards:\n\n### 📂 Project Management\n- Create and view projects\n- Manage project settings and members\n\n### 📊 Board Management\n- Create and view boards within projects\n- Customize board settings\n\n### 📋 List Management\n- Create and organize lists within boards\n- Reorder lists as needed\n\n### 🗂️ Card Management\n- Create, update, and delete cards\n- Move cards between lists\n- Add descriptions, due dates, and labels\n- Duplicate cards to create templates\n\n### ⏱️ Time Tracking\n- Start, stop, and reset stopwatches\n- Track time spent on individual tasks\n- Analyze time usage patterns\n\n### ✅ Task Management\n- Create and manage tasks within cards\n- Mark tasks as complete or incomplete\n\n### 💬 Comment Management\n- Add comments to cards for discussion\n- View comment history\n\n## 🤖 LLM Interaction Strategies\n\nMCP Kanban supports several workflow strategies for LLM-human collaboration:\n\n1. **🤝 LLM-Driven Development with Human Review**: LLMs implement tasks while humans review and provide feedback\n2. **👥 Human-Driven Development with LLM Support**: Humans implement while LLMs provide analysis and recommendations\n3. **🧠 Collaborative Grooming and Planning**: Humans and LLMs work together to plan and organize tasks\n\nFor more details on these strategies, see the [Capabilities and Strategies](https://github.com/bradrisse/kanban-mcp/wiki/Capabilities-and-Strategies) wiki page.\n\n## 📦 Available npm Scripts\n\n- `npm run build`: Build the TypeScript code\n- `npm run build-docker`: Build the TypeScript code and create a Docker image\n- `npm run up`: Start the Planka containers (kanban and postgres)\n- `npm run down`: Stop all containers\n- `npm run restart`: Restart the Planka containers\n- `npm run start-node`: Start the MCP server directly with Node (for testing outside of Cursor)\n- `npm run qc`: Run quality control checks (linting and type checking)\n\n## 🤝 Contributing\n\nWe welcome contributions to Kanban MCP! If you'd like to contribute:\n\n1. Check out the [Developer Guide](https://github.com/bradrisse/kanban-mcp/wiki/Developer-Guide) for information on the project structure and development workflow\n2. Look at the [open issues](https://github.com/bradrisse/kanban-mcp/issues) for tasks that need help\n3. Submit a pull request with your changes\n\n## 🆘 Support\n\nIf you need help with Kanban MCP:\n\n1. Check the [Troubleshooting](https://github.com/bradrisse/kanban-mcp/wiki/Troubleshooting) page for solutions to common issues\n2. Search the [GitHub issues](https://github.com/bradrisse/kanban-mcp/issues) to see if your problem has been reported\n3. Open a new issue if you can't find a solution\n\n## 📜 License\n\nKanban MCP is open-source software licensed under the MIT License. See the [LICENSE](https://github.com/bradrisse/kanban-mcp/blob/main/LICENSE) file for details. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisapool%2Fliterate-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffisapool%2Fliterate-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisapool%2Fliterate-guide/lists"}