项目简介

智能助手工具 MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用，旨在为大型语言模型 (LLM) 或 AI 助手提供结构化的上下文信息和功能，特别是任务管理和记忆存储。它通过标准化的方式，让 AI 能够理解和操作项目、任务、子任务以及持久化的记忆数据。

主要功能点

任务管理:
- 创建、查看、更新和删除项目、任务和子任务。
- 支持项目、任务、子任务的多层级组织。
- 跟踪任务和子任务的完成状态。
智能记忆:
- 存储和管理带有标题、详细内容和元数据的 AI 记忆。
- 提供基于文本内容的智能搜索功能，带有相关性评分。
- 支持记忆分类。
项目隔离存储:
- 所有任务和记忆数据都存储在指定的工作目录（例如项目目录）下的 '.agentic-tools-mcp' 文件夹中。
- 不同工作目录下的数据完全隔离，非常适合同时管理多个项目。
- 数据以文件形式存储（任务在一个JSON文件，记忆按类别分文件），方便通过 Git 等工具进行版本控制和团队协作。
MCP 工具集:
- 通过 MCP 协议暴露了一系列功能明确的工具，供 AI 助手调用，例如：
  - 'list_projects', 'create_project', 'get_project', 'update_project', 'delete_project'
  - 'list_tasks', 'create_task', 'get_task', 'update_task', 'delete_task'
  - 'list_subtasks', 'create_subtask', 'get_subtask', 'update_subtask', 'delete_subtask'
  - 'create_memory', 'search_memories', 'get_memory', 'list_memories', 'update_memory', 'delete_memory'

安装步骤

确保您的系统已安装 Node.js (建议使用最新的 LTS 版本)。
您可以选择以下任意一种方式获取并运行服务器：
- 使用 npx 临时运行 (推荐快速尝试): 在命令行执行：
```
npx -y @pimzino/agentic-tools-mcp
```
  'npx' 会自动下载并运行最新版本的服务器，无需全局安装。
- 全局安装 (长期使用): 在命令行执行：
```
npm install -g @pimzino/agentic-tools-mcp
```
  安装后，可以直接通过命令 'agentic-tools-mcp' 启动服务器，通常配合 MCP 客户端使用。

服务器配置 (针对 MCP 客户端)

这个 MCP 服务器主要通过标准输入/输出 (STDIO) 协议与客户端通信。在支持 MCP 的客户端 (如 Claude Desktop, AugmentCode 等) 中，需要将此服务器配置为一个外部 MCP 服务器。

典型的配置方式是提供服务器的启动命令 ('command') 和可选的参数列表 ('args')。配置信息通常是 JSON 格式，包含服务器的标识符 (如 'name') 和启动细节。

'command': 启动服务器的可执行命令。如果您是全局安装的，可能是 'agentic-tools-mcp'；如果您使用 'npx' 方式，命令就是 'npx'。
'args': 传递给 'command' 的参数列表。例如，使用 'npx' 时，参数可能是 '["-y", "@pimzino/agentic-tools-mcp"]'。

请查阅您所使用的 MCP 客户端的文档，了解如何在其中添加和配置外部 MCP 服务器。

重要提示: 所有通过 MCP 协议调用的工具（如 'create_project', 'create_memory', 'list_tasks' 等）都需要一个 'workingDirectory' 参数。这个参数必须是一个指向文件系统上实际存在的、绝对路径的目录。MCP 客户端在调用工具时会负责传递这个参数，以告诉服务器在哪里存储或查找数据（例如，通常是当前打开的项目文件夹）。请确保您配置的客户端能够正确传递这个参数。

基本使用方法

一旦服务器在 MCP 客户端中配置并成功启动连接，AI 助手就可以识别并调用此服务器提供的工具。

AI 助手可以通过调用 'list_projects' 工具来查看当前 'workingDirectory' 下的所有项目。
AI 助手可以通过调用 'create_task' 工具来在一个指定的 'workingDirectory' 和 'projectId' 下创建新任务。
AI 助手可以通过调用 'search_memories' 工具，提供 'workingDirectory' 和 'query' 参数来搜索相关的记忆。

AI 助手会根据用户的请求和当前上下文，选择调用合适的工具来管理任务或检索记忆。

有关每个工具的具体参数和预期输出，请参考仓库中的文档（例如 'docs/API_REFERENCE.md'）。

关键词

信息