Taskdriver MCP MCP Server安装配置 GitHub与使用方法

选型结论

Taskdriver MCP 属于AI代理类 MCP Server，公开资料标注 23 个工具，通过stdio 本地进程接入，客户端适配情况以官方文档为准，有可以直接复制的安装命令；接入前要先准备 API Key。

分类

AI代理

传输方式

stdio

认证方式

API Key

部署方式

公开资料未说明

安装与配置

安装命令

npx taskdriver-mcp --help

客户端配置示例

{
  "mcpServers": {
    "taskdriver-mcp": {
      "command": "npx",
      "args": [
        "taskdriver-mcp",
        "--help"
      ]
    }
  }
}

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Node.js，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 23 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

任务驱动程序MCP

一种模型上下文协议（MCP）服务器，用于将LLM代理作为任务运行器进行管理和编排。

安装

# Install globally
npm install -g taskdriver-mcp

# Or use directly with npx/bunx
npx taskdriver-mcp --help
bunx taskdriver-mcp --help

快速开始

CLI使用情况

# Create a new project
npx taskdriver-mcp create-project "my-project" "My first project"

# List projects
npx taskdriver-mcp list-projects

# Get project details
npx taskdriver-mcp get-project "my-project"

# Create a task type template
npx taskdriver-mcp create-task-type "my-project" "analysis"

# Create tasks
npx taskdriver-mcp create-task "my-project"

# Get next task for an agent
npx taskdriver-mcp get-next-task "my-project" "my-agent"

# Complete a task
npx taskdriver-mcp complete-task "my-agent" "my-project" "task-id" "Task completed"

MCP服务器模式

将TaskDriver作为MCP服务器运行以进行stdio传输：

npx taskdriver-mcp mcp

HTTP服务器模式

将TaskDriver作为HTTP REST API服务器运行：

npx taskdriver-mcp server

特性

多模式部署：MCP服务器（stdio）、HTTP REST API和CLI接口
项目型组织：按项目隔离任务、代理和配置
基于模板的任务类型：使用变量替换创建可重用的任务模板
原子任务分配：将无竞赛条件的任务分配给代理
租赁管理：自动清理过期的任务和失败的代理
多个存储后端：文件、MongoDB和Redis存储提供程序
综合监控：健康检查、指标和详细的项目统计数据
批处理：分组相关任务并跟踪批处理完成情况
重试逻辑：失败任务的可配置重试策略

部署模式

1.MCP服务器（stdio）

非常适合与支持模型上下文协议的LLM框架集成：

bun run mcp

MCP服务器提供19个工具用于完成任务管理：

项目管理（创建、列出、更新、删除）
任务生命周期（创建、分配、完成、失败）
代理操作（注册、状态）
监控（状态、指标、健康状况）

2.HTTP REST API

对于web应用程序和服务：

bun run http

访问API http://localhost:3000 所有操作都有完整的REST端点。

3.CLI界面

对于直接命令行使用和自动化：

taskdriver --help

核心概念

项目

项目为任务和代理提供了隔离的环境：

# Create a project
taskdriver create-project "ai-analysis" "AI-powered code analysis project" \\
  --instructions "@project-instructions.md" \\
  --max-retries 3 \\
  --lease-duration 15

# List projects
taskdriver list-projects

# Get project details
taskdriver get-project "ai-analysis"

任务类型

任务类型是用于创建类似任务的模板：

# Create a task type with template
taskdriver create-task-type "ai-analysis" "code-review" \\
  --template "@review-template.md" \\
  --variables "repository_url" "branch_name" "focus_area"

# List task types
taskdriver list-task-types "ai-analysis"

任务

任务是由代理执行的特定工作项：

# Create a task
taskdriver create-task "ai-analysis" "task-type-id" "Review security vulnerabilities" \\
  --variables '{"repository_url": "https://github.com/user/repo", "focus_area": "security"}'

# List tasks
taskdriver list-tasks "ai-analysis" --status queued

# Get task details
taskdriver get-task "task-id"

代理

代理是执行任务的工作人员：

# Register an agent
taskdriver register-agent "ai-analysis" "security-agent"

# Get next task for agent
taskdriver get-next-task "security-agent" "ai-analysis"

# Complete a task
taskdriver complete-task "security-agent" "ai-analysis" "task-id" \\
  --result '{"status": "completed", "findings": ["vulnerability1", "vulnerability2"]}'

文件读取支持

描述和模板都支持使用 @ 前缀：

# Project description from file
taskdriver create-project "my-project" "@project-description.txt"

# Project instructions from file
taskdriver create-project "my-project" "Short description" --instructions "@instructions.md"

# Task template from file
taskdriver create-task-type "my-project" "analysis" --template "@analysis-template.md"

配置

环境变量

核心配置

# Server Configuration
TASKDRIVER_HOST=localhost                    # Server host (default: localhost)
TASKDRIVER_PORT=3000                        # Server port (default: 3000)
TASKDRIVER_MODE=auto                        # Server mode: auto, mcp, http, cli

# Storage Provider
TASKDRIVER_STORAGE_PROVIDER=file            # Storage provider: file, mongodb, redis
TASKDRIVER_STORAGE_CONNECTION_STRING=       # Connection string for mongodb/redis

文件存储配置

TASKDRIVER_FILE_DATA_DIR=./data             # Data directory for file storage
TASKDRIVER_FILE_LOCK_TIMEOUT=30000          # File lock timeout in milliseconds

MongoDB配置

TASKDRIVER_MONGODB_DATABASE=taskdriver      # MongoDB database name
TASKDRIVER_MONGODB_OPTIONS={}               # MongoDB connection options (JSON)

Redis配置

TASKDRIVER_REDIS_DATABASE=0                 # Redis database number
TASKDRIVER_REDIS_KEY_PREFIX=taskdriver:     # Redis key prefix
TASKDRIVER_REDIS_OPTIONS={}                 # Redis connection options (JSON)

日志记录配置

TASKDRIVER_LOG_LEVEL=info                   # Log level: debug, info, warn, error
TASKDRIVER_LOG_PRETTY=false                 # Pretty print logs (true/false)
TASKDRIVER_LOG_CORRELATION=true             # Enable correlation IDs (true/false)

安全配置

TASKDRIVER_ENABLE_AUTH=true                 # Enable authentication (true/false)
TASKDRIVER_API_KEY_LENGTH=32                # API key length in characters
TASKDRIVER_SESSION_TIMEOUT=3600             # Session timeout in seconds

默认任务配置

TASKDRIVER_DEFAULT_MAX_RETRIES=3            # Default maximum retries for tasks
TASKDRIVER_DEFAULT_LEASE_DURATION=10        # Default lease duration in minutes
TASKDRIVER_REAPER_INTERVAL=1                # Reaper interval in minutes

存储提供商

文件存储（开发）

TASKDRIVER_STORAGE_PROVIDER=file
TASKDRIVER_FILE_DATA_DIR=./data

MongoDB（生产）

TASKDRIVER_STORAGE_PROVIDER=mongodb
TASKDRIVER_MONGODB_URI=mongodb://localhost:27017/taskdriver

Redis（高性能）

TASKDRIVER_STORAGE_PROVIDER=redis
TASKDRIVER_REDIS_URI=redis://localhost:6379

api参考

REST API

完整的REST API文档可在 /api/docs 当运行HTTP服务器时。

关键端点：

GET /api/projects -列出项目
POST /api/projects -创建项目
GET /api/projects/:id -获取项目详细信息
POST /api/projects/:id/tasks -创建任务
GET /api/projects/:id/tasks -列出任务
POST /api/agents/:name/tasks/assign -将任务分配给代理

MCP工具

当作为MCP服务器运行时，有19个工具可用：

项目管理:

create_project -创建新项目
list_projects -列出所有项目
get_project -获取项目详细信息
update_project -更新项目属性

任务管理:

create_task_type -创建任务模板
list_task_types -列出任务类型
create_task -创建新任务
list_tasks -列出带有筛选功能的任务
get_task -获取任务详细信息

代理操作:

register_agent -注册新代理
list_agents -列出代理
assign_task -将任务分配给代理
complete_task -将任务标记为已完成
fail_task -将任务标记为失败

监控:

get_project_stats -获取项目统计信息
health_check -系统健康检查
get_lease_stats -获取租赁统计信息
extend_task_lease -延长任务租约
cleanup_expired_leases -清理过期任务

监控和操作

健康检查

# Check system health
taskdriver health-check

# Get project statistics
taskdriver get-project-stats "my-project"

# Clean up expired leases
taskdriver cleanup-leases "my-project"

指标

运行HTTP服务器时，Prometheus指标可在以下网址获得 /metrics.

发展

测试

# Run all tests
bun test

# Run specific test suites
bun test test/services/
bun test test/storage/
bun test test/integration/

# Run with coverage
bun test --coverage

# E2E testing
./test/e2e/run-all-tests.sh

开发命令

# Development mode with hot reload
bun run dev

# Build TypeScript
bun run build

# Clean build artifacts
bun run clean

例子

请参阅文档/示例/ 完整使用示例目录：

文档

CLI参考 -完整的CLI命令文档
MCP工具参考 -MCP服务器工具文档
HTTP API参考 -REST API文档
配置指南 -详细的配置选项
部署指导 -生产部署说明
架构概述 -技术架构细节

贡献

请阅读贡献.md 有关我们的行为准则和提交pull请求流程的详细信息。

许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

工具与能力

工具数量

23

资源数量

0

提示词数量

0

能力标签

任务编排TypeScript本地部署LLM代理管理分布式任务工作流自动化模型上下文协议

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

多步任务编排

把拆解、检索、执行串成一条链，模型按步骤调用工具。

长期上下文

把会话、笔记和知识放到外部存储，换个会话还能接着做。

接自有流程

把内部系统和模型连起来，让助手调用已有的工作流。

选择建议

值得选的地方

工具数量 23 个，一次接入能覆盖的操作比单点工具更全。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

stdio 方式要求本地装好 Node.js，换机器要重新装一遍。
需要自备API Key，没有凭据没法直接试。
公开摘要偏短，具体能力和限制要回到仓库确认。

更适合

需要在AI代理场景里让模型直接调用外部能力的人。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
暂时拿不到API Key的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Taskdriver MCP MCP World · 本页	23	stdio	有	1 个	2026-05-17
Everything Claude Code MCP World	0	stdio	有	1 个	2026-05-17
Filesystem 560c4363 MCP World	13	未说明	未标注	2 个	2026-05-17
Time 7365cb6d MCP.so	2	SSE	有	2 个	2026-05-17
Server Everything (everything) MCP World	11	stdio	有	1 个	2026-05-17

常见问题

5 条

Taskdriver MCP 怎么安装？

公开资料给出的安装命令是 npx taskdriver-mcp --help，运行环境为 Node.js。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Taskdriver MCP 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Node.js；保存后完全退出客户端再打开，配置才会生效。

Taskdriver MCP 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Taskdriver MCP 需要 API Key 吗？

公开资料标注的认证方式是API Key，也就是要先拿到凭据才能连上；凭据只填在自己本地的配置里，不要写进公开仓库。

Taskdriver MCP 支持哪些客户端？

公开资料没有标注具体客户端；能配置本地 MCP 命令的客户端都能接，配置方式参照官方文档。

来源信息

MCP World

taskdriver-mcp

用于管理和编排LLM代理作为任务运行器的模型上下文协议服务器，支持多模式部署、项目隔离、模板任务和原子任务分配。

www.mcpworld.com

/detail/e958e26f92892b7bbffff4bcf7c17b9e

参考链接

仓库入口

github.com

/hamstudy/taskdriver-mcp

来源标签