Content
```FYI - This was just a quick prototype (NOT PRODUCTION CODE) to test MCP. 😃```
# MCP Checklist Server
A Model Context Protocol (MCP) server that generates markdown checklists with checkboxes for use with AI tools like Cursor and Claude.
https://github.com/user-attachments/assets/59ba395b-cbac-4204-a17e-b023cad5ea1d
## Features
- Creates properly formatted markdown checklists with checkboxes
- Works with Cursor, Claude Desktop, and any MCP-compatible client
- Supports customizable number of checklist items
- Formats output as `1. [ ] Item` for easy use in markdown documents
- Uses a low-level API approach for maximum compatibility
## Installation
```bash
# Clone the repository
git clone https://github.com/mikemikula/mcp-checklist.git
cd mcp-checklist
# Install dependencies using pnpm
pnpm install
```
## Setup for Cursor
1. Open Cursor
2. Go to Settings → Features → MCP Servers
3. Add a new server with these settings:
```json
"Checklist": {
"command": "node",
"args": [
"/path/to/your/mcp-checklist/src/mcp-checklist.js"
],
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
```
Replace the path with the actual path to your `mcp-checklist.js` file and add your OpenAI API key.
4. Restart Cursor to load the new configuration
For detailed setup instructions and troubleshooting, see [Cursor Setup Guide](docs/cursor-checklist-setup.md).
## Usage
In Cursor, you can use the checklist tool with prompts like:
- "Create a checklist for implementing user authentication"
- "Make a checklist for deploying a React app to AWS"
- "I need a checklist for optimizing a website's performance"
For more information on how AI assistants use this tool, see [MCP Integration Guide](docs/mcp-section.md).
## Testing with MCP Inspector
1. Run the server:
```
node src/mcp-checklist.js
```
2. In another terminal, run MCP Inspector:
```
npx @modelcontextprotocol/inspector
```
3. Connect to your server:
- Enter: `child:node src/mcp-checklist.js`
- Click "Connect"
4. Use the tool:
- Go to the "Tools" tab
- Click on "create_checklist"
- Fill in the "topic" field
- Click "Execute"
For more detailed testing instructions, see [MCP Guide](docs/mcp-guide.md).
## Debugging
Check the log file at `src/mcp-checklist.log` for detailed logs of server activity.
## Documentation
- [Cursor Setup Guide](docs/cursor-checklist-setup.md) - Instructions for setting up the MCP server in Cursor
- [MCP Guide](docs/mcp-guide.md) - Detailed guide on the MCP implementation
- [MCP Integration](docs/mcp-section.md) - How LLMs use this MCP server
## License
MIT
## Acknowledgements
- Built with the Model Context Protocol (MCP) SDK
- Powered by OpenAI's GPT models
Connection Info
You Might Also Like
markitdown
Python tool for converting files and office documents to Markdown.
Fetch
Retrieve and process content from web pages by converting HTML into markdown format.
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
skyflo
Self-hosted AI Agent for Kubernetes & DevOps
memo
Memo MCP -- save and restore conversation across agents
swift-ai-sdk
Swift AI SDK for building AI applications with ease.