待办事项管理服务器

一个简单的模型上下文协议(MCP)服务器,用于管理待办事项列表,适合学习MCP服务器工作原理。

  • by miguel-conde
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 miguel-conde/test_mcp

使用说明

全MCP服务器

一个用于管理待办事项列表的简单模型上下文协议(MCP)服务器。这是一个学习项目,旨在了解MCP服务器的工作原理。

特性

我们的Todo MCP服务器提供以下工具:

🔧 可用工具

  1. add_todo(标题、描述) -添加新的待办事项
  2. list_todos(显示已完成) -列出所有待办事项(可选包括已完成的)
  3. 完成所有(TODO_ID) -将待办事项标记为已完成
  4. 删除todo(tod/ID) -删除待办事项
  5. get_todo_sts() -获取您待办事项的统计数据

设置

  1. 创建虚拟环境:

    python3 -m venv .venv
    source .venv/bin/activate
    
  2. 安装依赖项:

    pip install -r requirements.txt
    
  3. 运行服务器:

    python todo_server.py
    

使用AI工具包

  1. 在VS代码中打开AI工具包
  2. 转到代理生成器
  3. 通过指向添加此MCP服务器 todo_server.py 文件
  4. 在操场上测试工具!

示例用法

连接后,您可以使用以下命令:

  • “添加待办事项以购买杂货”
  • “显示我的所有待办事项”
  • “将待办事项#1标记为完成”
  • “删除待办事项#2”
  • “显示我的待办事项统计信息”

数据存储

待办事项存储在 todos.json 与服务器位于同一目录中,因此它们在运行之间保持不变。

学习笔记

此MCP服务器演示:

  • ✅ 带有正确类型提示的工具定义
  • ✅ 参数的JSON模式生成
  • ✅ 数据持久性
  • ✅ 错误处理
  • ✅ 用户友好的响应
  • ✅ FastMCP框架使用