项目简介
这是一个遵循 Model Context Protocol (MCP) 标准实现的服务器应用程序。它提供了一组工具(Tool),允许大型语言模型(LLM)通过 MCP 协议与一个简单的任务列表进行交互,实现添加、查看、更新和删除待办事项的功能。
主要功能点
- 添加任务: 创建新的待办事项,可指定描述和优先级。
- 查看任务: 列出当前所有的待办事项,包括它们的 ID、描述、优先级和状态。
- 更新任务: 修改现有任务的信息,如描述、优先级或状态。
- 删除任务: 从列表中移除指定的任务。
安装步骤
- 确保您的系统已安装 Node.js v20 或更高版本以及 npm v10 或更高版本。推荐使用 nvm (Node Version Manager) 来管理 Node.js 版本。
- 克隆此 GitHub 仓库到您的本地机器。
- 打开终端,进入仓库目录。
- 运行以下命令安装项目依赖:
npm install - 运行以下命令构建项目:
构建成功后,可执行文件将在 'build' 目录下生成。npm run build
服务器配置
本 MCP 服务器通常由支持 MCP 协议的 LLM 客户端(如 Roo 或其他兼容应用)启动和管理。您需要在客户端的配置文件中添加如下信息,以便客户端知道如何启动并连接到此服务器:
客户端配置需要指定:
- 服务器名称 ('server name'): 一个用于识别此服务器的唯一名称,例如 'ai-taskmaster'。
- 启动命令 ('command'): 启动 Node.js 可执行文件的绝对路径。例如:'/Users/您的用户名/.nvm/versions/node/v20.11.0/bin/node' (macOS/Linux) 或 'C:\Users\您的用户名\AppData\Roaming\nvm\v20.11.0\node.exe' (Windows)。请替换为您的实际路径。
- 命令参数 ('args'): 一个数组,包含传递给启动命令的参数。第一个参数应是服务器构建后主脚本的绝对路径,即 'build/index.js' 文件的路径。例如:'/Users/您的用户名/Development/taskmaster_mcp/build/index.js' (macOS/Linux) 或 'C:\path\to\taskmaster_mcp\build\index.js' (Windows)。请替换为您的实际路径。
- 工作目录 ('cwd'): 服务器进程的工作目录,应设置为仓库的根目录绝对路径。例如:'/Users/您的用户名/Development/taskmaster_mcp' (macOS/Linux) 或 'C:\path\to\taskmaster_mcp' (Windows)。
- 传输类型 ('transportType'): 指定与客户端通信的方式。对于由客户端启动的进程,通常使用 'stdio'(标准输入/输出)。
- 描述 ('description'): 对该服务器功能的简要说明。
请根据您的实际安装路径,在 LLM 客户端的 MCP 配置中填写这些信息。
基本使用方法
配置完成后,当您与 LLM 进行交互时,LLM 可以根据其理解和您的指令,通过客户端调用此 MCP 服务器提供的工具。
例如:
- 如果您对 LLM 说 "帮我添加一个写文档的任务,优先级高",LLM 可能会调用 'addTask' 工具,并传递参数 '{ "description": "写项目文档", "priority": "high" }'。
- 如果您说 "列出所有任务",LLM 可能会调用 'listTasks' 工具。
- 如果您想标记某个任务已完成(需要知道任务 ID),LLM 可能会调用 'updateTask' 工具,传递 '{ "id": "...", "status": "done" }' 等参数。
服务器将执行相应的操作(读写本地的 'data/tasks.json' 文件),并将结果返回给 LLM,LLM 再将结果以自然语言或其他格式呈现给您。
信息
分类
AI与计算