Follow Plan MCP Server

遵循计划MCP服务器

一个全面的模型上下文协议（MCP）服务器，用于智能项目规划和任务管理，具有SQLite持久性和全文搜索功能。

特性

• 任务管理：创建、更新和跟踪具有状态、优先级和进度的任务
• 功能规划：管理用户故事、史诗和功能规范
• 缺陷追踪系统：报告和跟踪具有严重级别和复制步骤的错误
• 规则引擎：定义项目规则、验证和自动化指南
• 全文检索：对所有计划项目进行高级搜索，并进行相关性评分
• SQLite存储：具有FTS5全文搜索索引的持久存储
• 自动同步：数据库和文件系统之间的自动同步
• 备份/恢复：数据库备份和还原功能

快速开始

1.安装依赖项

npm install

2.建设项目

npm run build

3.启动MCP服务器

npm start /path/to/your/project

服务器将创建一个 .plan 项目中的目录，结构如下：

.plan/
├── database.db          # SQLite database
├── index.md            # Project overview
├── tasks/              # Task files
├── features/           # Feature files
├── bugs/               # Bug files
├── rules/              # Rule files
├── workflows/          # Workflow documentation
├── changelog/          # Project changelog
└── tmp/                # Temporary files and logs

MCP工具

任务管理

• create_task -创建新任务
• update_task -更新现有任务
• get_task -按ID获取任务详细信息
• list_tasks -列出带有可选筛选器的任务
• delete_task -删除任务

功能管理

• create_feature -创建新功能
• update_feature -更新现有功能
• get_feature -按ID获取功能详细信息
• list_features -列出带有可选过滤器的功能
• delete_feature -删除功能

缺陷追踪系统

• create_bug -创建新的错误报告
• update_bug -更新现有错误
• get_bug -按ID获取bug详细信息
• list_bugs -使用可选过滤器列出错误
• delete_bug -删除bug

规则管理

• create_rule -创建新的项目规则
• update_rule -更新现有规则
• get_rule -按ID获取规则详细信息
• list_rules -列出带有可选筛选器的规则
• delete_rule -删除规则

搜索与发现

• search -搜索所有计划项目
• advanced_search -使用过滤器进行高级搜索

数据管理

• backup_database -创建数据库备份
• restore_database -从备份还原
• sync_filesystem -将数据库同步到文件系统

MCP资源

• plan://index -项目计划概述（Markdown）
• plan://tasks -所有任务（JSON）
• plan://features -所有功能（JSON）
• plan://bugs -所有错误（JSON）
• plan://rules -所有规则（JSON）
• plan://stats -项目统计数据（JSON）

配置

克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "follow-plan": {
      "command": "node",
      "args": [
        "/path/to/follow-plan-mcp/dist/index.js",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

环境变量

• LOG_LEVEL -设置日志记录级别（调试、信息、警告、错误）
• PLAN_AUTO_SYNC -启用/禁用自动同步（默认值：true）
• PLAN_BACKUP_INTERVAL -备份间隔（秒）（默认值：1800）

发展

构建

npm run build

测试

npm test
npm run test:coverage

棉绒

npm run lint
npm run lint:fix

格式

npm run format

数据库模式

服务器使用SQLite和FTS5全文搜索。关键表格：

• tasks -项目任务
• features -功能规格
• bugs -Bug报告
• rules -项目规则
• messages -通信日志
• prompts -AI提示模板
• cascades -自动化工作流程
• fts_search -全文搜索索引

建筑

src/
├── index.ts              # Main MCP server
├── types/                # TypeScript type definitions
├── services/             # Business logic services
│   ├── database-service.ts
│   ├── task-service.ts
│   ├── feature-service.ts
│   ├── bug-service.ts
│   ├── rule-service.ts
│   ├── search-service.ts
│   └── persistence-service.ts
├── handlers/             # MCP request handlers
│   ├── tools.ts
│   ├── resources.ts
│   ├── validation.ts
│   └── search-handlers.ts
├── utils/                # Utility functions
└── constants/            # Application constants

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 添加测试
5. 运行测试套件
6. 提交拉取请求

许可证

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

支持

对于问题和疑问：

• GitHub问题：\[报告错误或请求功能\]
• 文件：见 /docs 目录
• 示例：参见 /examples 目录

______________________________________________________________________

遵循MCP计划 -面向人工智能时代的智能项目规划🚀