MCP Feature Tracker
2025.04.20
0
JavaScript项目管理任务跟踪笔记管理决策记录开发效率
MCP Feature Tracker 是一个轻量级的 Node.js 服务器，实现了 MCP（多能力合作伙伴）协议，用于基本的项目跟踪。该服务器帮助用户（或其 AI 编码助手）通过简单的 SQLite 数据库管理工作空间中的任务、笔记、决策和目标。
View on GitHub
Overview
基本能力
产品定位
MCP Feature Tracker 是一个轻量级的项目跟踪工具，旨在通过 MCP 协议提供任务管理、笔记记录、决策记录和目标跟踪功能。
核心功能
- 任务管理：创建、更新、删除和跟踪任务，支持状态（BACKLOG、IN_PROGRESS、DONE）和依赖关系。
- 笔记管理：添加和管理项目相关的笔记，可链接到任务并添加标签。
- 决策记录：记录设计决策及其理由和备选方案，可链接到任务。
- 目标跟踪：定义和跟踪高层次的项目目标。
- 搜索功能：支持跨任务、笔记和决策的搜索。
- MCP 兼容：通过标准化的 MCP API 暴露功能。
- SQLite 后端：使用简单的文件存储数据。
适用场景
- 个人或团队项目管理
- AI 编码助手辅助的项目跟踪
- 设计决策记录和回顾
- 项目目标设定和进度跟踪
使用教程
使用依赖
- Node.js：版本 16.x 或更高。
- npm 或 yarn：Node.js 的包管理器。
安装教程
- 克隆仓库：
bash git clone https://github.com/ChiefBoyardee/mcp-feature-tracker.git cd mcp-feature-tracker - 安装依赖：
bash npm install # 或 yarn install
配置
通过环境变量配置服务器：
- MCP_PORT：服务器监听的端口，默认为 31337。
- MCP_DATA_DIR：SQLite 数据库文件存储目录，默认为 ./.mcp_data。
示例（.env 文件或导出命令）：
MCP_PORT=31338
MCP_DATA_DIR=/path/to/your/persistent/data
运行服务器
直接运行：
node server.js
或使用 npm 脚本：
npm start
作为后台服务运行（可选）
使用 pm2：
1. 安装 pm2：
bash
npm install pm2 -g
2. 启动服务器：
bash
pm2 start server.js --name mcp-feature-tracker
3. 管理服务：
bash
pm2 list
pm2 stop mcp-feature-tracker
pm2 restart mcp-feature-tracker
pm2 logs mcp-feature-tracker
调试方式
查看服务器启动日志，确认监听的端口和数据目录是否正确。
常见问题解答
- 如何初始化项目上下文？：客户端需要调用
mcp_feature-tracker_initializeProjectContext端点，提供项目工作空间的绝对路径。 - 如何配置不同的 MCP 客户端？：参考 README 中的示例配置，确保提供正确的服务器 URL 和工具前缀。
- 数据存储在哪里？：默认存储在
./.mcp_data目录，可通过MCP_DATA_DIR环境变量更改。