AI导哈

项目追踪管理服务器

一个基于Go语言的模型上下文协议服务器，为LiteTracker项目管理系统提供11种工具，支持故事、评论、标签和所有者的管理，可直接从Claude Code或Claude Desktop使用。

  • by MelianLabs
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 MelianLabs/litetracker-mcp

使用说明

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 获取最近的项目活动

先决条件

安装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文件的自定义路径

获取您的凭据

  1. API代币：登录LiteTracker>配置文件>API令牌>创建新令牌
  2. 用户ID：运行 get_me 设置令牌后使用工具，或检查您的个人资料URL
  3. 电子邮件/密码：您的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不支持注释、标签或所有者分配的写入操作。

相关 MCP