LiteTracker MCP服务器
基于Go的 模型上下文协议(MCP) 服务器 LiteTracker 项目管理。提供11个工具,用于直接从Claude Code或Claude Desktop管理故事、评论、标签和所有者。
特性
| 工具 | 说明 |
|---|---|
get_me | 获取当前经过身份验证的用户信息 |
list_projects | 列出所有项目 |
list_stories | 列出带有过滤器(州、所有者、标签)的故事 |
get_story | 获取带有评论的故事 |
get_story_comments | 获取故事的评论 |
create_story | 创建新故事 |
post_comment | 对一个故事发表评论 |
find_owner | 按姓名或首字母搜索项目成员以查找其用户ID |
add_label | 为故事添加标签 |
add_owner | 通过user_id或名称将所有者添加到故事中(自动解析,保留现有) |
get_project_activity | 获取最近的项目活动 |
先决条件
- 转到1.25+ 安装
- DuckDB 已安装(守护进程/同步模式所需)
- A. LiteTracker 带有API令牌的帐户
安装DuckDB
curl https://install.duckdb.org | sh在Claude代码中安装
claude mcp add litetracker \
-e LITETRACKER_TOKEN=your_api_token \
-e LITETRACKER_EMAIL=your_email \
-e LITETRACKER_PASSWORD=your_password \
-e LITETRACKER_USER_ID=your_user_id \
-- go run github.com/MelianLabs/litetracker-mcp@latest serve注:LITETRACKER_EMAIL,LITETRACKER_PASSWORD,以及LITETRACKER_USER_ID是写入操作所必需的(注释、标签、所有者)。只读使用只需要LITETRACKER_TOKEN.
在Claude桌面中安装
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"litetracker": {
"command": "go",
"args": ["run", "github.com/MelianLabs/litetracker-mcp@latest", "serve"],
"env": {
"LITETRACKER_TOKEN": "your_api_token",
"LITETRACKER_EMAIL": "your_email",
"LITETRACKER_PASSWORD": "your_password",
"LITETRACKER_USER_ID": "your_user_id"
}
}
}
}从源代码安装
git clone https://github.com/MelianLabs/litetracker-mcp.git
cd litetracker-mcp
cp .env.example .env # Edit with your credentials
go build -ldflags="-s -w" -o litetracker .
# Register with Claude Code
claude mcp add litetracker -- ./litetracker serve配置
所有配置都是通过环境变量进行的。您还可以使用 .env 文件(从当前目录加载或 ~/litetracker-go/.env).
| 变量 | 必填 | 描述 |
|---|---|---|
LITETRACKER_TOKEN | 是 | 简介>API令牌中的API令牌 |
LITETRACKER_EMAIL | 用于写入 | 登录电子邮件以进行web会话身份验证 |
LITETRACKER_PASSWORD | 用于写入 | web会话身份验证的登录密码 |
LITETRACKER_USER_ID | 用于写作 | 您的用户ID(用于评论归因) |
LITETRACKER_USERNAME | 否 | 显示名称(用于守护进程提及检测) |
LITETRACKER_PROJECT_IDS | 对于守护进程 | 逗号分隔的项目ID |
POLL_INTERVAL_MS | 否 | 守护进程轮询间隔(默认值:300000ms) |
LITETRACKER_BASE_URL | 没有 | API基本URL(默认值: https://app.litetracker.com/services/v5) |
LITETRACKER_WEB_URL | 否 | Web基础URL(默认值: https://app.litetracker.com) |
LITETRACKER_DATA_DIR | 否 | 守护进程/sync DuckDB存储的数据目录 |
LITETRACKER_ENV_FILE | 否 | .env文件的自定义路径 |
获取您的凭据
- API代币:登录LiteTracker>配置文件>API令牌>创建新令牌
- 用户ID:运行
get_me设置令牌后使用工具,或检查您的个人资料URL - 电子邮件/密码:您的LiteTracker登录凭据(需要,因为API不支持注释/标签/所有者的写入操作)
子指令
| 命令 | 描述 |
|---|---|
serve | 启动MCP服务器(stdio传输) |
daemon | 后台守护进程:轮询活动,同步到DuckDB,发送macOS通知 |
sync | 一键同步:将所有故事/评论获取到DuckDB |
这 serve 命令是Claude Code/Desk集成所需的全部。这 daemon 和 sync 命令是维护本地DuckDB缓存的可选高级用户功能。
DuckDB数据库模式(表、索引、视图)在首次运行时自动创建 daemon 或 sync --无需手动设置。
建筑
服务器使用两种身份验证方法:
- API版本5 (令牌认证):读取操作和故事创建
- 内部
/api/v1/(web会话身份验证):写入操作(注释、标签、所有者)——自动登录并重试会话到期
这种双重方法是必要的,因为LiteTracker的公共API不支持注释、标签或所有者分配的写入操作。
