MCP功能跟踪器
一个轻量级的Node.js服务器，实现了用于基本项目跟踪的MCP（多功能伙伴关系）协议。此服务器可帮助您（或您的AI编码助手！）使用简单的SQLite数据库直接从您的工作区跟踪项目任务、笔记、决策和目标。
特性
以下是此服务器可以为您做的事情：
- 任务管理： 创建、更新、删除和跟踪具有状态（BACKLOG、IN_PROGRESS、DONE）和依赖关系的任务。
- 笔记： 添加和管理与项目相关的注释，可选择将其链接到任务并添加标签。
- 决定： 记录设计决策及其基本原理和替代方案，并将其与任务联系起来。
- 目标： 定义并跟踪高级项目目标。
- 搜索： 跨任务、笔记和决策进行搜索。
- 符合MCP标准： 通过标准化的MCP API展示功能。
- SQLite后端： 简单的基于文件的数据存储。
先决条件
- Node.js： 建议使用16.x或更高版本。
- npm 或 纱线： Node.js的包管理器。
安装
- 克隆存储库：
git clone https://github.com/ChiefBoyardee/mcp-feature-tracker.git
cd mcp-feature-tracker- 安装依赖项：
npm install
# or
yarn install配置
您可以使用这些设置（通常在启动服务器之前设置为环境变量）调整服务器的运行方式：
MCP_PORT：服务器将侦听的端口。默认为31337.MCP_DATA_DIR：存储SQLite数据库文件的目录。默认为./.mcp_data相对于服务器的运行目录。如果此目录不存在，服务器将创建它。
*（注：默认端口 31337 除非另有说明，否则在下面的客户端配置示例中使用。)*
示例(.env 文件或导出命令）：
MCP_PORT=31338
MCP_DATA_DIR=/path/to/your/persistent/data运行服务器
让服务器运行很简单：
您可以直接使用Node.js运行服务器：
node server.js或者使用中定义的npm脚本 package.json:
npm start服务器将记录其启动状态，包括它正在侦听的端口和它正在使用的数据目录。
作为后台服务运行（可选）
希望服务器在您关闭终端后仍能继续运行吗？你可以使用以下工具 pm2 或者操作系统的服务管理器。
使用 pm2 （一个流行的Node.js进程管理器）：
- 安装
pm2全球范围内（如果您还没有）：npm install pm2 -g - 使用启动服务器
pm2:
# Basic start
pm2 start server.js --name mcp-feature-tracker
# Start with environment variables
MCP_PORT=31338 MCP_DATA_DIR=/your/chosen/data/path pm2 start server.js --name mcp-feature-tracker- 管理服务：
pm2 list,pm2 stop mcp-feature-tracker,pm2 restart mcp-feature-tracker,pm2 logs mcp-feature-tracker.
平台特定注意事项：
- 窗户： 您可以使用
pm2在Windows上，或创建计划任务。确保MCP_DATA_DIR路径是有效的Windows语法（例如。，C:\Users\YourUser\mcp_server_data). - macOS/Linux：
pm2或创建systemd服务文件是常见的方法。确保运行服务器的用户具有对的写入权限MCP_DATA_DIR.
用法：连接MCP客户端
任何兼容MCP的客户端（如AI编码助手）都可以连接到此服务器来管理项目信息。
重要初始化步骤： 在您的客户端可以与服务器讨论 *特定的* 在项目中，有一个重要步骤：初始化。客户端需要告诉服务器 绝对路径 到项目的工作区文件夹。这允许服务器为该项目使用正确的数据库。
这是通过向 mcp_feature-tracker_initializeProjectContext 端点：
// Example MCP Tool Call
{
"tool_name": "mcp_feature-tracker_initializeProjectContext",
"parameters": {
"workspaceFolderPath": "/absolute/path/to/your/project/workspace"
// On Windows, use double backslashes or forward slashes:
// "workspaceFolderPath": "C:\Users\YourUser\Documents\MyProject"
// "workspaceFolderPath": "C:/Users/YourUser/Documents/MyProject"
}
}初始化后，客户端可以使用其他端点，如 addTask, getTasks, addNote, getDecisions等等。
客户端配置示例
以下是如何配置不同MCP客户端以使用此服务器的示例。用实际的服务器详细信息和项目路径替换占位符。 有关最准确的配置方法，请参阅特定客户的文档。
1.光标：
通过编辑光标来配置光标 mcp.json 文件（通常通过以下方式找到 Settings ⚙️ > MCP > + Add new global MCP server)
"cursor.mcpProviders": [
{
"name": "Local Feature Tracker",
"apiBaseUrl": "http://localhost:31337", // Or your configured MCP_PORT
"toolPrefix": "mcp_feature-tracker" // Conventionally matches the server's prefix
}
]*记得打电话 initializeProjectContext 将工作区路径作为新Cursor项目中的第一个操作。*
2.风浪：
通过其用户界面配置Windsurf，可能是通过设置菜单、级联面板（锤子图标🔨 -> 配置）或聊天面板（+配置MCP）：
- 查找添加/管理MCP服务器的部分。
- 提供一个名称（例如“本地功能跟踪器”）。
- 输入服务器URL:
http://localhost:31337（或您配置的MCP_PORT). - 输入工具前缀：
mcp_feature-tracker.
*需要初始化调用：* mcp_feature-tracker_initializeProjectContext 随着 workspaceFolderPath.
3.克劳德代码：
通过其设置菜单配置克劳德代码：
- 查找与MCP或工具服务器相关的部分。
- 添加新的服务器配置。
- 提供一个名称（例如“MyTracker”）。
- 输入基本URL：
http://localhost:31337/ - （可选）设置工具筛选器（如果可用）：
mcp_feature-tracker_*
*需要初始化调用：* mcp_feature-tracker_initializeProjectContext 随着 workspaceFolderPath.
4.Cline（CLI工具）：
通过设置环境变量配置Cline *之前* 运行命令或编辑其配置文件：
# Set environment variables for the current session
export MCP_SERVER_URL=http://localhost:31337
export MCP_TOOL_PREFIX=mcp_feature-tracker
# First command for a project (initialization)
cline mcp call mcp_feature-tracker_initializeProjectContext '{"workspaceFolderPath": "/path/to/project"}'
# Subsequent commands
cline mcp call mcp_feature-tracker_addTask '{"title": "New Task", "description": "..."}'5.房间：
使用Roo的设置界面配置Roo：
- 服务器名称： 本地功能跟踪器
- 基本URL:
http://localhost:31337 - 工具前缀：
mcp_feature-tracker - *（需要通过Roo的界面/第一个命令进行初始化调用）*
重要提示： 虽然这些示例提供了常见的模式，但请始终参考特定MCP客户端的文档，以获取最新和最准确的配置方法。所需的关键细节是服务器的基本URL(http://localhost:PORT)以及工具前缀(mcp_feature-tracker).
贡献
欢迎投稿！请随时在 .
存储库：
作者 Boyardee酋长jayjewellroth@gmail.com
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。