Todo MCP 服务器

这是一个使用模型上下文协议（MCP）构建的简单待办事项应用程序，用于测试和演示 MCP 交互。

概述

此存储库包含一个最小的待办事项应用程序，作为 MCP 服务器实现。它允许您执行以下操作：

• 列出所有待办事项
• 查看特定待办事项
• 添加新的待办事项
• 删除待办事项
• 清除所有待办事项
• 创建带元数据的结构化任务

此项目作为一个测试床，用于与模型上下文协议服务器交互并了解如何通过 MCP 协议构建和暴露功能。有关模型上下文协议的更多信息，请访问 modelcontextprotocol.io。

先决条件

• Python 3.10 或更高版本
• uv（Python 包安装工具）

安装

1. 克隆仓库：

git clone https://github.com/idsulik/todo-mcp-server.git
cd todo-mcp-server

2. 使用 uv 安装依赖项：

uv pip install -e .

添加到 MCP 服务器列表

要将此服务器添加到您的 MCP 服务器列表中，请使用以下命令：

mcp install server.py --name "Todo MCP"

这会将服务器注册到 Claude 桌面应用程序或其他支持 MCP 的应用程序。

如果需要使用 MCP 检查器测试服务器，可以使用：

mcp dev server.py

这将启动服务器，并附带 MCP 检查器界面，方便测试和调试。

API 使用

该服务器通过以下 MCP 资源和工具公开接口：

资源

1. 列出所有待办事项：

GET todo://list

2. 查看特定待办事项：

GET todo://view/{item_idx}

其中 item_idx 是您要查看的待办事项索引。

提示

1. 创建结构化任务：

create_task(task_name: str, priority: str = "medium", due_date: str = "")

此提示帮助格式化带有优先级和截止日期的待办事项任务。参数：

• task_name：任务的名称/描述
• priority：任务优先级（low、medium、high）
• due_date：任务的截止日期（可选）

工具

1. 添加新待办事项：

add_todo(value: str)

2. 删除待办事项：

remove_todo(item_idx: int)

3. 清除所有待办事项：

clear_todo()

手动添加到 MCP 配置

如果愿意手动将服务器添加到您的 MCP 配置中，可以向 Claude 桌面配置文件添加以下 JSON（通常位于 ~/.claude-desktop/claude_desktop_config.json 或 C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "todo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        server.py
      ]
    }
  }
}

请将 server.py 替换为实际的文件路径。

Docker

要使用 Docker 运行服务器，请运行以下命令：

docker pull ghcr.io/idsulik/todo-mcp-server:latest
docker run -it ghcr.io/idsulik/todo-mcp-server:latest

贡献

欢迎为该项目提交代码合并请求！