To Do List MCP 服务器

这是一个简单的 To Do 列表管理器的模型上下文协议 (MCP) 实现，它通过 MCP 工具提供基本的 CRUD 操作。

功能特性

• 添加新的 To Do 项
• 查看所有 To Do 项
• 通过 ID 删除 To Do 项
• 使用 Zod 验证的类型安全操作
• 为了简单起见，使用内存存储
• 使用 Stdio 传输，易于集成

安装

npm install @modelcontextprotocol/sdk zod

使用方法

运行服务器：

npm run start

可用工具：

1. add-todo: 添加新的 To Do 项

• 参数: {text: string}
• 返回值：带有分配 ID 的成功消息

2. get-todos: 获取所有 To Do 项

• 返回值：所有项的格式化列表或空状态消息

3. remove-todo: 删除 To Do 项

• 参数: {id: number}
• 返回值：删除成功消息；如果未找到 ID，则返回错误

使用示例

// 添加一个新的 todo
await client.callTool({
    name: "add-todo",
    arguments: { text: "Buy groceries" }
});

// 获取所有 todos
await client.callTool({ name: "get-todos" });

// 删除一个 todo
await client.callTool({
    name: "remove-todo",
    arguments: { id: 1 }
});

实现细节

• 使用 MCP Server SDK 以符合协议
• 实现工具模式进行操作
• 使用 stdio 传输进行通信
• 为了简单起见，在内存中维护状态

测试

使用 MCP 客户端（如 claude）测试服务器：

1. 运行服务器
2. 使用 MCP Inspector 连接
3. 单独测试每个工具
4. 验证响应和错误处理