Systemprompt MCP Taskchecker

🚀 SystemPrompt MCP TaskChecker

SystemPrompt MCP TaskChecker 是一款企业级的模型上下文协议（MCP）服务器，用于智能任务管理、评估评分和基于会话的工作流跟踪。它能与 AI 助手无缝集成，为下一代 AI 驱动的生产力解决方案提供结构化的任务编排、实时进度监控和全面的评估指标。

---

🚀 快速开始

前提条件

• Node.js：版本 18.0.0 或更高
• npm：最新稳定版本
• TypeScript：包含在 devDependencies 中

快速启动

# 克隆仓库
git clone https://github.com/Ejb503/systemprompt-mcp-taskchecker.git
cd systemprompt-mcp-taskchecker

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

开发环境

# 开发模式，支持热重载
npm run dev

# 运行测试
npm test

# 运行覆盖率测试
npm run test:coverage

# 测试客户端集成
npm run test:client

Docker 部署

# 构建 Docker 镜像
npm run docker:build

# 在容器中运行
npm run docker:run

---

✨ 主要特性

📌 SystemPrompt MCP TaskChecker 是什么？

SystemPrompt MCP TaskChecker 是一个模型上下文协议（MCP）服务器，它改变了 AI 助手处理任务管理和工作流编排的方式。由 SystemPrompt.io 构建，这个企业级解决方案弥合了 AI 智能与结构化生产力工作流之间的差距。

🎯 关键价值主张

• 🤖 原生 AI 任务管理：专为与 Claude、GPT 等 AI 助手无缝集成而设计
• 📊 智能评估评分：0 - 100 分的评分系统，具备全面的指标跟踪
• ⚡ 基于会话的架构：有状态、安全且自动管理的会话
• 🏢 企业就绪：具备全面错误处理的生产级可靠性
• 🔄 实时工作流跟踪：实时状态更新和进度监控
• 🛡️ 安全合规：内置验证、会话管理和数据完整性

🌟 核心功能

🎯 智能任务编排

• 动态任务列表：创建和管理复杂的任务层次结构，支持可选的初始化操作
• 智能状态跟踪：实时更新任务状态（pending → in_progress → completed）
• 验收标准：为每个任务定义清晰、可衡量的完成要求
• 灵活更新：修改任何任务属性，并保持数据完整性

📈 高级评估系统

• 精准评分：为已完成的任务提供 0 - 100 的评估等级
• 质量指标：跟踪任务完成质量和性能指标
• 历史分析：维护评估历史，以实现持续改进
• 成功基准：比较和分析任务完成模式

🔒 企业会话管理

• 有状态操作：在多个交互中保持上下文
• 自动清理：智能会话超时和资源管理
• 并发支持：处理多个同时进行的会话
• 安全验证：内置会话 ID 验证和错误处理

🚀 生产级架构

• 符合 MCP 2025 - 03 - 26 标准：遵循最新的模型上下文协议标准
• 可流式 HTTP 传输：高性能、可扩展的通信
• 结构化错误处理：全面的错误响应和日志记录
• 原生 TypeScript：提供完整的类型安全和良好的开发体验

---

💻 使用示例

🌱 基础用法

基本任务列表创建

{
  "method": "tools/call",
  "params": {
    "name": "create_tasklist",
    "arguments": {
      "initialTasks": [
        {
          "title": "Implement user authentication",
          "acceptanceCriteria": "User can login with email/password and receive JWT token"
        },
        {
          "title": "Create dashboard UI",
          "acceptanceCriteria": "Responsive dashboard showing user metrics and navigation"
        }
      ]
    }
  }
}

任务状态更新

{
  "method": "tools/call",
  "params": {
    "name": "update_task",
    "arguments": {
      "taskListId": "uuid-task-list-id",
      "taskId": "uuid-task-id",
      "updates": {
        "status": "completed",
        "evaluation": 95
      }
    }
  }
}

全面状态检索

{
  "method": "tools/call",
  "params": {
    "name": "get_status",
    "arguments": {
      "taskListId": "uuid-task-list-id"
    }
  }
}

---

📚 详细文档

🔧 MCP 工具参考

create_tasklist

该方法用于为当前会话创建一个新的任务列表，支持可选的初始任务。

参数	类型	是否必需	描述
initialTasks	Array<Task>	否	要创建的初始任务数组

响应结构：

{
  success: boolean;
  data: {
    id: string;
    sessionId: string;
    tasks: Task[];
    createdAt: Date;
    lastAccessed: Date;
  }
}

update_task

该方法用于更新特定任务的属性，包括状态、评估和元数据。

参数	类型	是否必需	描述
taskListId	string	是	目标任务列表的 ID
taskId	string	是	要更新的任务的 ID
updates	TaskUpdates	是	包含要更新属性的对象

可用更新内容：

• title：任务标题（字符串）
• status：任务状态（pending | in_progress | completed）
• acceptanceCriteria：完成标准（字符串）
• evaluation：质量评分（0 - 100）

get_status

该方法用于检索所有任务或特定任务的当前状态。

参数	类型	是否必需	描述
taskListId	string	是	要查询的任务列表的 ID
taskId	string	否	可选的特定任务 ID

📊 数据模型

任务结构

interface Task {
  id: string;                    // 唯一的任务标识符
  title: string;                 // 任务标题/描述
  status: TaskStatus;            // 当前任务状态
  acceptanceCriteria: string;    // 完成要求
  evaluation?: number;           // 质量评分（0 - 100）
  createdAt: Date;              // 创建时间戳
  updatedAt: Date;              // 最后修改时间戳
}

type TaskStatus = 'pending' | 'in_progress' | 'completed';

任务列表结构

interface TaskList {
  id: string;                    // 唯一的列表标识符
  sessionId: string;             // 关联的会话 ID
  tasks: Task[];                 // 任务数组
  createdAt: Date;              // 创建时间戳
  lastAccessed: Date;           // 最后访问时间戳
}

🏗️ 架构概述

系统组件

┌─────────────────────────────────────────────────────────────┐
│                   AI Assistant (Claude, GPT)                │
└─────────────────────┬───────────────────────────────────────┘
                      │ MCP Protocol
┌─────────────────────▼───────────────────────────────────────┐
│              SystemPrompt MCP TaskChecker                   │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   HTTP      │  │   Session   │  │    Task Service     │  │
│  │  Transport  │  │  Manager    │  │                     │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   Tool      │  │   Config    │  │   In-Memory Store   │  │
│  │  Handlers   │  │  Manager    │  │                     │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

技术栈

• 运行时环境：Node.js 18+
• 编程语言：TypeScript
• 协议：模型上下文协议（MCP）2025 - 03 - 26
• 传输方式：可流式 HTTP
• 存储：具有自动清理功能的内存存储
• 框架：Express.js
• 包管理器：npm

🔒 安全与合规

安全特性

• ✅ 会话验证：采用加密安全的会话 ID
• ✅ 输入验证：全面的参数验证
• ✅ 错误处理：结构化的错误响应，无信息泄漏
• ✅ 速率限制就绪：架构支持速率限制实现
• ✅ 传输安全：生产部署支持 HTTPS/TLS

合规标准

• 符合 MCP 协议：完全兼容 MCP 2025 - 03 - 26
• 数据隐私：内存存储，自动清理
• 企业安全：基于会话的隔离和验证

📈 性能与扩展

性能特点

• 内存高效：内存存储，智能清理
• 低延迟：典型操作的响应时间低于毫秒级
• 并发会话：支持 1000 多个同时进行的会话
• 自动扩展就绪：无状态架构，支持水平扩展

资源限制

资源	默认限制	可配置
每个列表的最大任务数	100	✅
最大任务列表数	5	✅
会话持续时间	5 分钟	✅
并发会话数	1000	✅
评估范围	0 - 100	✅

🌐 部署选项

生产部署

# 环境变量
export NODE_ENV=production
export PORT=3000
export LOG_LEVEL=info

# 启动生产服务器
npm start

Docker 生产环境

FROM node:18-alpine
WORKDIR /app
COPY . .
RUN npm ci --only=production && npm run build
EXPOSE 3000
CMD ["npm", "start"]

云集成

• AWS：与 ECS、Lambda 和 EC2 兼容
• Google Cloud：支持 Cloud Run、GKE 和 Compute Engine
• Azure：适用于 Container Instances、AKS 和 App Service
• Railway/Vercel：支持一键部署

🧪 测试与质量保证

测试覆盖率

# 单元测试
npm test

# 集成测试
npm run test:client

# 覆盖率报告
npm run test:coverage

# 开发测试
npm run test:watch

质量工具

• TypeScript：提供完整的类型安全和编译时检查
• ESLint：强制代码质量和一致性
• Prettier：自动代码格式化
• Jest：全面的测试框架

📚 API 文档

健康检查端点

GET /health

返回服务器健康状态和活动会话计数。

GET /sessions

列出活动会话（用于开发/调试）。

DELETE /sessions/:sessionId

手动清理特定会话（用于测试）。

MCP 端点

POST /mcp

用于工具交互的主要 MCP 协议端点。

🤝 集成示例

Claude 桌面集成

添加到您的 Claude 桌面配置中：

{
  "mcpServers": {
    "systemprompt-taskchecker": {
      "command": "npx",
      "args": ["systemprompt-mcp-taskchecker"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

自定义 AI 助手集成

import { MCPClient } from '@modelcontextprotocol/sdk/client/index.js';

const client = new MCPClient({
  transport: new HTTPClientTransport('http://localhost:3000/mcp')
});

// 创建任务列表
const result = await client.callTool('create_tasklist', {
  initialTasks: [
    {
      title: 'Setup development environment',
      acceptanceCriteria: 'All dependencies installed and tests passing'
    }
  ]
});

🎯 使用案例

🔧 开发工作流

• 跟踪编码任务和里程碑
• 管理代码审查要求
• 监控部署清单
• 评估任务完成质量

📋 项目管理

• 构建项目可交付成果
• 跟踪验收标准合规性
• 生成进度报告
• 维护质量基准

🏢 企业运营

• 标准化工作流流程
• 实施质量关卡
• 跟踪团队绩效指标
• 自动化任务编排

🤖 AI 助手增强

• 提供结构化任务上下文
• 实现持久的工作流记忆
• 支持复杂的多步骤流程
• 促进评估和改进

🛠️ 开发与贡献

开发设置

# 分叉并克隆仓库
git clone https://github.com/YOUR_USERNAME/systemprompt-mcp-taskchecker.git
cd systemprompt-mcp-taskchecker

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 以监视模式运行测试
npm run test:watch

代码质量标准

• TypeScript：启用严格模式
• ESLint：采用 Airbnb 配置并自定义规则
• Prettier：保持一致的代码格式
• Jest：最低 80% 的测试覆盖率
• Conventional Commits：标准化提交消息

📊 监控与可观测性

内置监控

• 健康检查：/health 端点提供详细状态
• 会话跟踪：实时监控活动会话
• 性能指标：请求/响应时间和成功率
• 错误跟踪：结构化错误日志记录，包含会话上下文

日志配置

# 设置日志级别
export LOG_LEVEL=debug  # debug, info, warn, error

# 启用结构化日志
export STRUCTURED_LOGS=true

🌟 为什么选择 SystemPrompt.io？

SystemPrompt.io 处于 AI 生产力创新的前沿，致力于创建企业级解决方案，将人类智能与人工智能无缝结合。我们的 MCP TaskChecker 体现了我们对以下方面的承诺：

• 🚀 创新：前沿的 AI 集成技术
• 🏢 企业导向：生产就绪、可扩展的解决方案
• 🔒 安全至上：内置安全和合规功能
• 🌐 开放标准：完全符合模型上下文协议
• 💡 开发者体验：直观的 API 和全面的文档

我们的使命

通过智能工作流编排和生产力解决方案，赋能组织充分发挥 AI 的潜力。

📞 支持与资源

🔗 快速链接

• 🏠 主页：https://systemprompt.io
• 📖 文档：https://systemprompt.io/docs/mcp-taskchecker
• 💬 支持：https://systemprompt.io/support
• 🐛 问题反馈：GitHub Issues
• 📧 联系我们：ed@tyingshoelaces.com

🤝 社区

• GitHub 讨论：分享想法和提问
• Discord 服务器：即将推出实时社区支持
• 博客：systemprompt.io/blog 提供最新更新和教程

---

📄 许可证

MIT 许可证

Copyright 2025 SystemPrompt.io

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---