MCP 服务器

project-planner-MCP

Enables AI assistants like Claude to create and manage projects, todos, priorities, and statuses through natural language, bridging the gap between AI and project management workflows.

README

📋 project-planner-MCP

A Model Context Protocol (MCP) server for AI-powered project and task management — create projects, manage todos, track priorities, and monitor progress seamlessly through any MCP-compatible AI assistant.

🌟 Overview

project-planner-ai-MCP is a lightweight, AI-native project management server built on the Model Context Protocol (MCP). It allows AI assistants like Claude to create and manage projects and todos on your behalf — directly from natural language conversations, with no manual UI required.

Whether you're planning a software project, organizing tasks, or tracking team progress, project-planner-ai-MCP bridges the gap between your AI assistant and your project management workflow.

✨ Features

🗂 Project Management — Create, retrieve, and delete projects
✅ Todo Management — Add, update, and delete todos within projects
🔴 Priority Levels — Assign high, medium, or low priority to every task
📊 Status Tracking — Track todos as pending, in-progress, or completed
🤖 AI-Native — Fully operable through any MCP-compatible AI assistant
⚡ Lightweight — Minimal dependencies, fast setup

🚀 Getting Started

Prerequisites

Node.js v24 or higher
An MCP-compatible AI client (e.g., Claude Desktop)

Installation

Clone the repository:

git clone https://github.com/Enockkipkoech/project-planner-MCP.git
cd project-planner-ai-MCP

Install dependencies:

npm install

Build the project:

npm run build

Configuration

Add the server to your MCP client configuration file (e.g., claude_desktop_config.json):

{
	"mcpServers": {
		"project-planner-mcp": {
			"command": "node",
			"args": ["/absolute/path/to/project-planner-MCP/build/index.js"]
		}
	}
}

Restart your MCP client and the server will be available.

🛠 Usage

Available Tools

Tool	Description
`create-project`	Create a new project with a name and optional description
`list-projects`	List all existing projects
`get-project`	Retrieve a single project by ID
`delete-project`	Delete a project and all its associated todos
`create-todo`	Add a new todo to a project with title, priority, and status
`update-todo`	Update an existing todo's title, description, priority, or status
`delete-todo`	Delete a specific todo by ID
`get-todo-by-id`	Fetch todos for a project, optionally filtered by status

Examples

Create a project:

"Create a new project called E-Commerce Application"

Add todos:

"Add a high priority todo for User Authentication to my E-Commerce project"

Update status:

"Mark the Shopping Cart todo as in-progress"

List all todos:

"Show me all pending todos for the E-Commerce Application"

🤝 Integration with Claude

project-planner-MCP works seamlessly with Claude Desktop and Claude.ai via the MCP connector system. Once configured:

Open Claude Desktop
Start a conversation — Claude will automatically detect the available tools
Ask Claude to manage your projects in plain English

No extra commands or syntax required — just talk to your AI assistant naturally.

📁 Project Structure

project-planner-MCP/
├── src/
│   ├── index.ts          # MCP server entry point
│   ├── tools/            # Tool definitions and handlers
│   └── storage/          # Data persistence layer
├── build/                # Compiled output
├── package.json
├── tsconfig.json
└── README.md