Todo MCP Server

一个使用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 Desktop应用程序或其他支持MCP的应用程序中。

如果您想使用MCP Inspector测试服务器，可以使用：

mcp dev server.py

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

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：任务优先级（低、中、高）
• due_date：任务的截止日期（可选）

工具

1. 添加新的待办事项：

add_todo(value: str)

2. 移除待办事项：

remove_todo(item_idx: int)

3. 清除所有待办事项：

clear_todo()

手动添加到MCP配置

如果您希望手动将服务器添加到MCP配置中，可以在您的Claude Desktop配置文件中添加以下JSON（通常位于Mac/Linux上的~/.claude-desktop/claude_desktop_config.json或Windows上的C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "todo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/your/server.py"
      ]
    }
  }
}

请将 /path/to/your/server.py 替换为您服务器.py文件的绝对路径。确保使用绝对路径，而不是相对路径。

使用Docker

您也可以使用Docker运行此MCP服务器，而无需在本地安装任何内容。在您的Claude Desktop配置中添加以下内容：

{
  "mcpServers": {
    "todo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "idsulik/todo-mcp-server"
      ]
    }
  }
}

如果Docker镜像尚未存在于您的系统上，Docker镜像将自动从Docker Hub拉取。

贡献

欢迎贡献！请随时提交Pull Request。 </中文翻译>