代理工具MCP服务器

](https://badge.fury.io/js/@pimzino%2Fagentic-tools-mcp) ](https://www.npmjs.com/package/@pimzino/agentic-tools-mcp) ](https://github.com/Pimzino/agentic-tools-mcp/stargazers) ](https://github.com/Pimzino/agentic-tools-mcp/blob/main/LICENSE) ](https://nodejs.org/)

一个全面的模型上下文协议（MCP）服务器，为AI助手提供强大的 高级任务管理 和 代理记忆 能力与 项目专用存储.

🔗 生态系统

此MCP服务器是完整任务和内存管理生态系统的一部分：

🖥️ VS代码扩展 -美观的GUI界面，可直接在VS Code中管理任务和内存
⚡ MCP服务器 （此存储库）-用于智能任务管理的高级人工智能代理工具和API

💡 专业建议：将两者结合使用，获得终极生产力体验！VS Code扩展提供了一个可视化界面，而MCP服务器使AI助手能够与PRD解析、任务推荐和研究功能等高级功能集成。

特性

🎯 无限层次高级任务管理系统（v1.8.0）

项目：将工作组织成具有描述的不同项目
统一任务模型：单任务界面支持无限嵌套深度
无限层次结构：任务→ 子任务→ 子任务→ 无限深度嵌套
各级功能丰富：每个任务都有优先级、复杂性、依赖关系、标签和时间跟踪
亲子关系：灵活的层次结构组织 parentId 领域
级别跟踪：自动层次计算和可视化指标
树可视化：全面的层次树显示，深度不限
智能依赖关系：具有跨层次验证的任务依赖关系管理
优先级和复杂性：各级1-10个规模优先级和复杂性估计
增强的状态跟踪：待定、正在进行、已阻止、已完成状态工作流
基于标签的组织：灵活的分类和过滤
时间跟踪：项目规划的估计和实际小时数
自动迁移：从旧的3级无缝升级到无限深度模型
进度跟踪：监控所有层次结构级别的完成状态
项目特定存储：每个工作目录都有独立的任务数据
Git可跟踪：任务数据可以与代码一起提交

🧠 Agent记忆系统

持久存储器：存储和检索带有标题和详细内容的代理记忆
智能搜索：多字段文本搜索，对标题、内容和类别进行相关性评分
智能排名：高级评分算法优先考虑标题匹配（60%）、内容匹配（30%）和类别奖金（20%）
元数据：用于增强上下文的灵活元数据系统
JSON存储：按类别组织的单个JSON文件，以内存标题命名
项目特定：每个工作目录的独立内存存储

🔧 MCP工具可用

项目管理

list_projects -查看工作目录中的所有项目
create_project -在工作目录中创建新项目
get_project -获取详细的项目信息
update_project -编辑项目名称/描述
delete_project -删除项目和所有相关数据

任务管理（无限层次结构v1.8.0）

list_tasks -以层次树格式查看任务，具有无限的深度可视化
create_task -使用以下命令在任何层次结构级别创建任务 parentId （支持无限嵌套）
get_task -获取包括层次关系在内的详细任务信息
update_task -使用以下命令编辑任务、元数据或在层次结构级别之间移动 parentId
delete_task -递归删除任务和所有子任务
move_task -用于在层次结构中移动任务的专用工具
migrate_subtasks -用于将遗留子任务转换为统一模型的自动迁移工具

高级任务管理（AI代理工具）

parse_prd -解析产品需求文档并自动生成结构化任务
get_next_task_recommendation -根据依赖关系、优先级和复杂性获得智能任务建议
analyze_task_complexity -分析任务复杂性，并建议分解过于复杂的任务
infer_task_progress -分析代码库，从实现证据中推断任务完成状态
research_task -引导AI代理通过内存集成进行全面的网络研究
generate_research_queries -为任务研究生成智能、有针对性的网络搜索查询

传统子任务管理（向后兼容性）

list_subtasks -查看子任务（传统兼容性，现在使用统一的任务模型）
create_subtask -创建子任务（遗留兼容性，创建具有 parentId)
get_subtask -获取任务信息（现有子任务的传统兼容性）
update_subtask -编辑子任务（与旧版兼容，使用统一的任务操作）
delete_subtask -删除子任务（遗留兼容性，递归删除任务）

代理内存管理

create_memory -用标题和详细内容存储新的记忆
search_memories -使用具有相关性评分的智能多字段搜索查找记忆
get_memory -获取详细的内存信息
list_memories -列出具有可选过滤功能的记忆
update_memory -编辑内存标题、内容、元数据或分类
delete_memory -删除内存（需要确认）

重要：所有工具都需要 workingDirectory 参数，指定数据应存储在何处。这使得项目特定的任务和内存管理成为可能。

安装

快速开始

npx -y @pimzino/agentic-tools-mcp

全球安装

npm install -g @pimzino/agentic-tools-mcp

用法

存储模式

MCP服务器支持两种存储模式：

📁 项目特定模式（默认）

数据存储在 .agentic-tools-mcp/ 每个项目工作目录中的子目录。

npx -y @pimzino/agentic-tools-mcp

🌐 全局目录模式

使用 --claude 标记以将所有数据存储在标准化的全局目录中：

视窗: C:\Users\{username}\.agentic-tools-mcp\
macOS/Linux: ~/.agentic-tools-mcp/

npx -y @pimzino/agentic-tools-mcp --claude

何时使用 --claude 标志：

使用Claude Desktop客户端（非项目特定用途）
当您希望为所有任务和记忆提供一个单一的全局工作空间时
适用于跨多个项目工作的AI助手

备注：使用时 --claude 旗 workingDirectory 所有工具中的参数都被忽略，而是使用全局目录。

使用克劳德桌面

项目特定模式（默认）

{
  "mcpServers": {
    "agentic-tools": {
      "command": "npx",
      "args": ["-y", "@pimzino/agentic-tools-mcp"]
    }
  }
}

全局目录模式（建议用于Claude Desktop）

{
  "mcpServers": {
    "agentic-tools": {
      "command": "npx",
      "args": ["-y", "@pimzino/agentic-tools-mcp", "--claude"]
    }
  }
}

备注：服务器现在包括任务管理和代理内存功能。

使用AugmentCode

项目特定模式（默认）

打开增强设置面板（齿轮图标）
添加MCP服务器：

- 名字: agentic-tools - 命令: npx -y @pimzino/agentic-tools-mcp

重新启动VS代码

全局目录模式

打开增强设置面板（齿轮图标）
添加MCP服务器：

- 名字: agentic-tools - 命令: npx -y @pimzino/agentic-tools-mcp --claude

重新启动VS代码

可用功能：任务管理、代理记忆和基于文本的搜索功能。

使用VS代码扩展（推荐）

为了获得最佳用户体验，请安装 代理工具MCP Companion VS代码扩展名：

克隆配套扩展存储库
在VS Code中打开它并按 F5 以开发模式运行
享受一个漂亮的GUI界面，用于所有任务和内存管理

两者结合使用的好处：

🎯 可视化任务管理：具有优先级、复杂性、状态、标签和时间跟踪的丰富表单
🎨 增强的用户界面：状态表情符号、优先级徽章和视觉指示器
🔄 实时同步：人工智能助手可以立即更改VS代码
📁 项目整合：与您的工作空间无缝集成
🤖 人工智能协作：人工规划与人工智能执行，实现最佳生产力

与其他MCP客户端

服务器使用STDIO传输，可以与任何兼容MCP的客户端集成：

项目特定模式

npx -y @pimzino/agentic-tools-mcp

全局目录模式

npx -y @pimzino/agentic-tools-mcp --claude

数据模型

项目

{
  id: string;           // Unique identifier
  name: string;         // Project name
  description: string;  // Project overview
  createdAt: string;    // ISO timestamp
  updatedAt: string;    // ISO timestamp
}

任务（统一模型v1.8.0-无限制层次结构）

{
  id: string;                    // Unique identifier
  name: string;                  // Task name
  details: string;               // Enhanced description
  projectId: string;             // Parent project reference
  completed: boolean;            // Completion status
  createdAt: string;             // ISO timestamp
  updatedAt: string;             // ISO timestamp

  // Unlimited hierarchy fields (v1.8.0)
  parentId?: string;             // Parent task ID for unlimited nesting (NEW)
  level?: number;                // Computed hierarchy level (0, 1, 2, etc.) (NEW)

  // Enhanced metadata fields (from v1.7.0)
  dependsOn?: string[];          // Task dependencies (IDs of prerequisite tasks)
  priority?: number;             // Priority level (1-10, where 10 is highest)
  complexity?: number;           // Complexity estimate (1-10, where 10 is most complex)
  status?: string;               // Enhanced status: 'pending' | 'in-progress' | 'blocked' | 'done'
  tags?: string[];               // Tags for categorization and filtering
  estimatedHours?: number;       // Estimated time to complete (hours)
  actualHours?: number;          // Actual time spent (hours)
}

传统子任务（在v1.8.0中已弃用）

独立的子任务接口已被统一的任务模型所取代。遗留子任务会自动迁移到具有 parentId 现场。这确保了无限的层次深度，同时在每个级别上保持所有丰富的功能。

记忆

{
  id: string;                    // Unique identifier
  title: string;                 // Short title for file naming (max 50 characters)
  content: string;               // Detailed memory content/text (no limit)
  metadata: Record; // Flexible metadata object
  createdAt: string;            // ISO timestamp
  updatedAt: string;            // ISO timestamp
  category?: string;            // Optional categorization
}

工作流示例

创建项目

   Use create_project with:
   - workingDirectory="/path/to/your/project"
   - name="Website Redesign"
   - description="Complete overhaul of company website"

添加增强任务

   Use create_task with:
   - workingDirectory="/path/to/your/project"
   - name="Design mockups"
   - details="Create wireframes and high-fidelity designs"
   - projectId="[project-id-from-step-1]"
   - priority=8 (high priority)
   - complexity=6 (above average complexity)
   - status="pending"
   - tags=["design", "ui", "mockups"]
   - estimatedHours=16

分解任务

   Use create_subtask with:
   - workingDirectory="/path/to/your/project"
   - name="Create wireframes"
   - details="Sketch basic layout structure"
   - taskId="[task-id-from-step-2]"

跟踪进度

   Use update_task and update_subtask to mark items as completed
   Use list_projects, list_tasks, and list_subtasks to view progress
   (All with workingDirectory parameter)

Agent记忆工作流

创造记忆

   Use create_memory with:
   - workingDirectory="/path/to/your/project"
   - title="User prefers concise technical responses"
   - content="The user has explicitly stated they prefer concise responses with technical explanations. They value brevity but want detailed technical information when relevant."
   - metadata={"source": "conversation", "confidence": 0.9}
   - category="user_preferences"

搜索记忆

   Use search_memories with:
   - workingDirectory="/path/to/your/project"
   - query="user preferences responses"
   - limit=5
   - threshold=0.3
   - category="user_preferences"

列表和管理

   Use list_memories to view all memories
   Use update_memory to modify existing memories (title, content, metadata, category)
   Use delete_memory to remove outdated memories
   (All with workingDirectory parameter)

📖 快速开始：参见 docs/QUICK_START_MEMORIES.md 获取代理记忆的分步指南。

数据存储

项目特定：每个工作目录都有自己的隔离任务和内存数据
基于文件：任务数据存储在 .agentic-tools-mcp/tasks/，内存数据输入 .agentic-tools-mcp/memories/
Git可跟踪：所有数据都可以与项目代码一起提交
持久：所有数据在服务器重新启动之间保持不变
原子：所有操作都是原子操作，以防止数据损坏
JSON存储：简单的基于文件的存储，实现高效的内存组织
备份友好：简单的基于文件的存储，便于备份和迁移

存储结构

your-project/
├── .agentic-tools-mcp/
│   ├── tasks/              # Task management data for this project
│   │   └── tasks.json      # Projects, tasks, and subtasks data
│   └── memories/           # JSON file storage for memories
│       ├── preferences/    # User preferences category
│       │   └── User_prefers_concise_technical_responses.json
│       ├── technical/      # Technical information category
│       │   └── React_TypeScript_project_with_strict_ESLint.json
│       └── context/        # Context information category
│           └── User_works_in_healthcare_needs_HIPAA_compliance.json
├── src/
├── package.json
└── README.md

工作目录参数

所有MCP工具都需要 workingDirectory 参数，指定：

在哪里存放 .agentic-tools-mcp/ 文件夹（在项目特定模式下）
要访问哪个项目的任务和内存数据
允许多个项目具有单独的任务列表和内存存储

备注：服务器启动时使用 --claude 旗 workingDirectory 参数被忽略，取而代之的是使用全局用户目录(~/.agentic-tools-mcp/ 在macOS/Linux或 C:\Users\{username}\.agentic-tools-mcp\ 在Windows上）。

项目特定存储的好处

Git集成：任务和内存数据可以与代码一起提交
团队协作：通过版本控制共享任务列表和代理内存
项目隔离：每个项目都有自己的任务管理和存储系统
多项目工作流：在孤立的记忆中同时处理多个项目
备份和迁移：基于文件的存储随代码一起传输
文本搜索：用于智能上下文检索的简单基于内容的内存搜索
代理连续性：跨会话和部署的持久代理内存

错误处理

验证：所有输入都经过全面的错误消息验证
目录验证：确保工作目录存在并且可访问
参照完整性：防止带有级联删除的孤立任务/子任务
唯一名称：在范围（项目/任务）内强制使用唯一名称
确认：破坏性操作需要明确确认
故障弱化：用于故障排除的详细错误消息
存储错误：存储初始化失败时清除消息

发展

从源头构建

git clone 
cd agentic-tools-mcp
npm install
npm run build
npm start

项目结构

src/
├── features/
│   ├── task-management/
│   │   ├── tools/           # MCP tool implementations
│   │   │   ├── projects/    # Project CRUD operations
│   │   │   ├── tasks/       # Task CRUD operations
│   │   │   └── subtasks/    # Subtask CRUD operations
│   │   ├── models/          # TypeScript interfaces
│   │   └── storage/         # Data persistence layer
│   └── agent-memories/
│       ├── tools/           # Memory MCP tool implementations
│       │   └── memories/    # Memory CRUD operations
│       ├── models/          # Memory TypeScript interfaces
│       └── storage/         # JSON file storage implementation
├── server.ts            # MCP server configuration
└── index.ts             # Entry point

故障排除

常见问题

“工作目录不存在”

确保路径存在且可访问
使用绝对路径保证可靠性
检查目录权限

“文本搜索不返回结果” （代理记忆）

尝试使用不同的关键字或短语
检查记忆中是否包含搜索词
验证查询内容是否与内存内容匹配

“找不到内存文件” （代理记忆）

确保工作目录存在并且可写
检查是否已创建.agentic-tools mcp/memories目录

版本历史记录

看更改日志.md 查看详细的版本历史和发行说明。

当前版本：1.8.0

🚀 新：统一任务模型：单任务界面支持无限嵌套深度
🚀 新增：无限层次结构：任务→ 子任务→ 子任务→ 无限深度嵌套
🚀 新增：自动迁移：从3级无缝升级到无限深度模型
🚀 新增：增强的树显示：具有级别指示器和无限深度的分层可视化
🚀 新增：层次结构工具: move_task, migrate_subtasks 用于无限深度管理
✅ 各级功能丰富：每个任务都有优先级、复杂性、依赖关系、标签和时间跟踪
✅ 增强的任务管理：具有依赖关系、优先级、复杂性、状态、标签和时间跟踪的丰富元数据
✅ 高级AI代理工具：PRD解析、任务推荐、复杂性分析、进度推断和研究指导
✅ 智能任务依赖关系：跨层次的依赖性验证和工作流管理
✅ 优先级和复杂性系统：各级1-10个规模优先级和复杂性估计
✅ 增强的状态工作流：待定→ 进行中→ 阻塞→ 完成状态跟踪
✅ 基于标签的组织：灵活的分类和过滤系统
✅ 时间跟踪：项目规划的估计和实际小时数
✅ 混合研究集成：为AI代理提供内存缓存的Web研究
✅ 完整的任务管理系统 具有无限的层级组织
✅ 特工记忆 具有标题/内容架构和JSON文件存储
✅ 智能多领域搜索 具有相关性评分
✅ 项目特定存储 使用全面的MCP工具
✅ 全局目录模式 claude Desktop带有--claude标志
✅ VS代码扩展生态系统 整合

致谢

我们感谢开源社区和以下项目，使这个MCP服务器成为可能：

核心技术

@模型上下文协议/sdk -MCP服务器实现的基础
**** -基于文件的可靠存储，实现内存持久性
TypeScript -类型安全的JavaScript开发
**** -JavaScript运行时环境

开发与验证

萨德 -TypeScript优先模式验证，实现稳健的输入处理
埃斯林特 -代码质量和一致性
更漂亮 -代码格式

文件存储和搜索

JSON -用于内存存储的简单、人类可读的数据格式
文本搜索 -跨内存文件的高效基于内容的搜索

特别感谢

开源社区 -用于创建使此项目成为可能的工具和库

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

欢迎投稿！请随时提交问题和拉取请求。

开发设置

git clone 
cd agentic-tools-mcp
npm install
npm run build
npm start

支持

有关问题和疑问，请使用GitHub问题跟踪器。

文档

📖 api参考 -完整的工具文档
🧠 特工记忆指南 -全面的存储系统指南
🚀 快速入门：回忆 -开始记忆特工
📋 更新日志 -版本历史和发行说明

获取帮助

🐛 通过GitHub问题报告bug
💡 通过GitHub讨论请求功能
🖥️ VS代码扩展问题：报告扩展特定问题代理工具mcp伴侣

Agentic Tools MCP Server

快速接入

详细介绍

代理工具MCP服务器

🔗 生态系统

特性

🎯 无限层次高级任务管理系统（v1.8.0）

🧠 Agent记忆系统

🔧 MCP工具可用

项目管理

任务管理（无限层次结构v1.8.0）

高级任务管理（AI代理工具）

传统子任务管理（向后兼容性）

代理内存管理

安装

快速开始

全球安装

用法

存储模式

📁 项目特定模式（默认）

🌐 全局目录模式

使用克劳德桌面

项目特定模式（默认）

全局目录模式（建议用于Claude Desktop）

使用AugmentCode

项目特定模式（默认）

全局目录模式

使用VS代码扩展（推荐）

与其他MCP客户端

项目特定模式

全局目录模式

数据模型

项目

任务（统一模型v1.8.0-无限制层次结构）

传统子任务（在v1.8.0中已弃用）

记忆

工作流示例

Agent记忆工作流

数据存储

存储结构

工作目录参数

项目特定存储的好处

错误处理

发展

从源头构建

项目结构

故障排除

常见问题

版本历史记录

当前版本：1.8.0

致谢

核心技术

开发与验证

文件存储和搜索

特别感谢

许可证

贡献

开发设置

相关项目

🖥️ VS代码扩展

支持

文档

获取帮助

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP