关键词

Todo服务任务管理FastMCP后端服务MCP工具

项目简介

这是一个简单的 Model Context Protocol (MCP) 服务器端实现，使用 Python 语言和 'FastMCP' 框架构建。它提供了一组标准的工具（Tools），允许兼容 MCP 协议的客户端（如大型语言模型应用）通过 JSON-RPC 调用来管理待办事项（Todos）。

主要功能点

该 MCP 服务器通过其定义的工具提供以下功能：

  • 创建待办事项: 添加一个新的待办事项到列表中。
  • 列出所有待办事项: 获取当前存储的所有待办事项列表。
  • 获取单个待办事项: 根据唯一标识符（ID）查找并返回特定的待办事项。
  • 更新待办事项: 修改已有待办事项的标题或完成状态。
  • 删除待办事项: 从列表中移除指定的待办事项。

安装步骤

  1. 确保您已安装 Python 环境。
  2. 安装必要的依赖库 'mcp'： 
    pip install mcp
  3. 将项目代码保存到本地文件，例如 'main.py'。

服务器配置（供 MCP 客户端参考）

为了让 MCP 客户端能够连接并使用此服务器，需要配置以下信息。这些信息定义了客户端如何启动和连接到服务器进程。典型的配置会是一个包含这些信息的 JSON 对象。

  • 'name': 服务器的标识名称。根据仓库代码，此名称为 '"todo-server"'。
  • 'command': 用于启动服务器进程的可执行命令。对于这个 Python 应用，通常是 '"python"'。
  • 'args': 传递给启动命令的参数列表。这里需要运行 'main.py' 文件，所以参数列表为 '["main.py"]'。
  • 'transport': 服务器使用的传输协议。仓库代码中配置的是 '"stdio"'（标准输入输出）。

一个 MCP 客户端配置该服务器时，会使用类似这样的结构（以 JSON 格式为例）：

{
  "name": "todo-server",
  "command": "python",
  "args": ["main.py"],
  "transport": "stdio"
}

MCP 客户端将使用这些信息来启动 'main.py' 脚本，并通过标准输入/输出通道与服务器进行 MCP 协议通信，从而能够调用其提供的工具。

基本使用方法

服务器启动后（例如通过上述配置被 MCP 客户端启动），它将监听来自客户端的 JSON-RPC 请求。客户端可以调用服务器暴露的工具。例如，要创建一个待办事项，客户端会发送一个调用 'create_todo' 工具的请求，包含新待办事项的标题数据。服务器执行该工具，处理待办事项列表，并将结果（如新创建的待办事项对象）返回给客户端。其他工具如 'list_todos', 'get_todo', 'update_todo', 'delete_todo' 也通过类似的方式调用。

信息

分类

生产力应用

访问项目