MCP Todo Server

用于待办事项管理的基本 MCP 服务器，作为哥斯达黎加拉丁大学编程 IV 的课外作业 1 (MCP) 的一部分开发。

作者：Adonis Fabricio Fajardo Rojas

描述

该服务器通过模型上下文协议（Model Context Protocol）提供以下功能：

• Resource tasks://all：以 JSON 格式返回完整任务列表。

• Tool add\_task(nombre, descripcion, prioridad)：添加新任务。

• Tool complete\_task(task\_id)：根据 ID 将任务标记为已完成。

• Prompt daily\_summary：生成任务状态摘要模板。

要求

• Python 3.10 或更高版本

• pip

安装

1. 克隆仓库：

   git clone \[URL-de-tu-repo]

   cd mcp-todo-server

2. 创建并激活虚拟环境：

   python -m venv venv

   venv\\Scripts\\activate

3. 安装依赖：

   pip install -r requirements.txt

运行

开发模式（使用 MCP Inspector）

mcp dev server.py

这会打开一个本地 Web 界面，用于直接测试 Resources、Tools 和 Prompts，而无需完整的 MCP 客户端。

连接 Claude Desktop

将以下配置添加到 claude\_desktop\_config.json 文件中：

{

  "mcpServers": {

    "todo-server": {

      "command": "python",

      "args": \["C:\\\\Users\\\\adoni\\\\mcp-todo-server\\\\server.py"]

    }

  }

}

项目结构

mcp-todo-server/ ├── server.py # 主要 MCP 服务器 ├── tasks.json # 任务存储 ├── requirements.txt # 依赖项 └── README.md # 本文件

兼容性说明

本项目使用官方 SDK mcp==1.29.0。不建议升级到 mcp>=2.0.0，因为该版本引入了不兼容的更改（例如将 FastMCP 重命名为 MCPServer），并且在完成本作业时无法保证其与 Claude Desktop 的兼容性。