MCP-Server
This project is a serverless Project Planner MCP backend built with Cloudflare Workers and TypeScript. It allows AI agents to create and manage projects and todos using MCP tools, with data stored in Cloudflare KV. The API supports full CRUD operations, input validation with Zod, and provides endpoints for MCP and SSE communication.
About
This project is a serverless Project Planner MCP backend built with Cloudflare Workers and TypeScript. It allows AI agents to create and manage projects and todos using MCP tools, with data stored in Cloudflare KV. The API supports full CRUD operations, input validation with Zod, and provides endpoints for MCP and SSE communication.
Features
- Project Management: Create, read, update, and delete projects
- Todo Management: Create, read, update, and delete todos within projects
- MCP Protocol: Full support for MCP (Model Context Protocol) tools and resources
- SSE Endpoints: Server-Sent Events for real-time updates
- Input Validation: Zod schemas for type-safe input validation
- Cloudflare KV: Serverless data storage
- TypeScript: Fully typed codebase
Tech Stack
- Cloudflare Workers: Serverless runtime
- TypeScript: Type-safe development
- Zod: Schema validation
- Model Context Protocol: AI agent integration
- Cloudflare KV: Data storage
Getting Started
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
- Cloudflare account (for deployment)
Installation
- Install dependencies:```bash
npm install
2. Configure your Cloudflare KV namespace in `wrangler.jsonc`
3. Start the development server:```bash
npm run dev
Deploy
Deploy to Cloudflare Workers:```bash
npm run deploy
## API Endpoints
### MCP Tools
- `list_tools` - List available MCP tools
- `create_project` - Create a new project
- `get_project` - Get project details
- `list_projects` - List all projects
- `update_project` - Update project details
- `delete_project` - Delete a project
- `create_todo` - Create a new todo
- `get_todo` - Get todo details
- `list_todos` - List all todos for a project
- `update_todo` - Update todo details
- `delete_todo` - Delete a todo
## Development```bash
npm run dev # Start dev server
npm run deploy # Deploy to Cloudflare
npm run format # Format code with Biome
npm run lint:fix # Fix linting issues
npm run type-check # Type check without emit
License
MIT
