AI导哈

AI开发工作流协调服务器

Handoff MCP是一款AI辅助开发工作流协调服务器，通过战略规划与战术实施之间的结构化交接，提供项目管理、任务跟踪和智能脚手架功能，适用于复杂开发流程管理。

  • by coladapo
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 coladapo/handoff-mcp

使用说明

切换MCP服务器

人工智能辅助开发的战略到战术工作流编排。弥合高层规划和实际执行之间的差距。

概述

Handoff MCP是一个模型上下文协议服务器，通过在战略规划和战术实施之间创建清晰的切换，帮助人工智能助手管理复杂的开发工作流程。它提供项目管理、任务跟踪和智能脚手架功能。

主要特点

  • 🏗️ 项目管理 -使用标签和元数据将工作组织到项目中
  • 📋 切换系统 -创建从战略到实施的结构化交接
  • 🚀 智能脚手架 -从模板生成项目结构
  • 💾 本地存储 -SQLite数据库，实现快速、离线优先操作
  • 🤖 NLP分析 -智能需求解析和分类
  • 📊 分析 -跟踪项目进度和成功指标

安装

通过npm（推荐）

npm install -g handoff-mcp

来源

git clone https://github.com/coladapo/handoff-mcp.git
cd handoff-mcp
npm install
npm run build

配置

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

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

对于当地发展：

{
  "mcpServers": {
    "handoff": {
      "command": "node",
      "args": ["/absolute/path/to/handoff-mcp/dist/index.js"]
    }
  }
}

使用示例

创建项目

// Using the MCP tool in Claude
await use_tool('create_project', {
  name: 'E-commerce Platform',
  description: 'Modern e-commerce site with React and Node.js',
  tags: ['web', 'fullstack', 'production'],
  default_project_info: {
    language: 'TypeScript',
    framework: 'React + Express',
    build_command: 'npm run build',
    test_command: 'npm test'
  }
});

创建Handoff

await use_tool('create_handoff', {
  project_id: 'proj_123',
  title: 'Implement user authentication',
  strategic_context: 'Need secure user authentication for the platform with JWT tokens and OAuth support',
  tactical_requirements: [
    'Create login/signup endpoints',
    'Implement JWT token generation',
    'Add OAuth2 providers (Google, GitHub)',
    'Create middleware for route protection'
  ],
  acceptance_criteria: [
    'Users can register with email/password',
    'JWT tokens expire after 24 hours',
    'OAuth login works with Google',
    'Protected routes return 401 when unauthorized'
  ],
  priority: 'high'
});

生成脚手架

await use_tool('generate_scaffold', {
  template_name: 'express',
  project_name: 'auth-service',
  target_path: './services/auth',
  variables: {
    port: 3001,
    database: 'PostgreSQL',
    authentication: true
  }
});

可用工具

项目管理

工具 说明
create_project 使用元数据创建新项目
list_projects 列出所有经过筛选的项目
get_project 获取详细的项目信息
archive_project 归档已完成的项目
get_project_stats 获取项目分析和指标

切换管理

工具 说明
create_handoff 创建从战略到战术的交接
get_handoff 检索切换详细信息
list_handoffs 列出带有过滤功能的交接
update_handoff_status 更新切换进度
add_handoff_note 为切换添加注释
verify_handoff 验证完成标准
generate_implementation_brief 制定详细的实施计划

脚手架

工具 说明
list_templates 列出可用的项目模板
preview_scaffold 生成前预览文件
generate_scaffold 生成项目结构
analyze_requirements NLP需求分析

项目模板

切换MCP包括几个内置模板：

  • 表达 -Node.js Express API服务器
  • 快速 -Python FastAPI后端
  • 反应 -React前端应用程序
  • mcp服务器 -MCP服务器样板

数据存储

数据存储在SQLite本地：

  • 位置: ~/.puo-memo/cursor_handoffs.db
  • 备份：自动每日备份
  • 隐私：所有数据都保留在您的机器上

建筑

handoff-mcp/
├── src/
│   ├── index.ts           # MCP server entry point
│   ├── storage.ts          # SQLite database layer
│   ├── types.ts            # TypeScript interfaces
│   └── scaffolding/        # Template engine
│       └── ScaffoldingEngine.ts
├── templates/              # Project templates
│   ├── express/
│   ├── fastapi/
│   ├── react/
│   └── mcp-server/
└── tests/                  # Test suite

发展

先决条件

  • Node.js 18+
  • npm或纱线
  • TypeScript 5.5+

设置

# Clone repository
git clone https://github.com/coladapo/handoff-mcp.git
cd handoff-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Development mode
npm run dev

测试

# Run all tests
npm test

# Run specific test suite
npm run test:storage
npm run test:scaffolding

# Test coverage
npm run test:coverage

贡献

我们欢迎捐款！请看 贡献.md 作为指导方针。

贡献领域

  • 其他项目模板
  • 增强的NLP功能
  • 云存储适配器
  • 与更多AI助手集成
  • 改进分析和报告

路线图

  • []云同步支持（Supabase/PPostgreSQL）
  • []团队协作功能
  • []项目概述的Web仪表板
  • []GitHub集成
  • []自定义模板创建UI
  • []实时进度跟踪
  • []导出/导入功能

支持

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

致谢

与 模型上下文协议SDK 通过Anthropic。

由以下材料制成❤️ 面向人工智能辅助开发社区

相关 MCP