AI导哈

时间跟踪服务

SolidTime的MCP服务器，用于从Claude、Cursor或任何MCP兼容客户端启动/停止计时器，管理时间条目、项目、客户、标签和任务。

  • by SwamiRama
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 SwamiRama/solidtime-mcp-server

使用说明

solidtime mcp服务器

MCP服务器 SolidTime 的 --开源时间追踪应用程序。启动/停止计时器，直接从Claude、Cursor或任何兼容MCP的客户端管理时间条目、项目、客户端、标签和任务。

特性

  • 22工具 涵盖时间条目、项目、客户端、标签、任务和用户信息
  • 启动/停止计时器 具有自动活动定时器检测功能
  • 汇总报告 按天、周、项目、客户等分组
  • 自动成员id解析 --无需手动配置
  • 可操作的错误消息 -每个错误告诉你下一步该怎么做
  • 零外部依赖 超越MCP SDK（使用本机 fetch)
  • 适用于自托管SolidTime实例和托管版本

快速开始

使用npx（无需安装）

npx solidtime-mcp-server

全局安装

npm install -g solidtime-mcp-server

环境变量

变量 必填 默认 描述
SOLIDTIME_API_TOKEN 是 - 您的SolidTime API令牌
SOLIDTIME_ORGANIZATION_ID 是 -- 您的组织UUID
SOLIDTIME_API_URL 没有 https://app.solidtime.io 自托管实例的基本URL

从获取您的API令牌 SolidTime>设置>API.

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "solidtime": {
      "command": "npx",
      "args": ["-y", "solidtime-mcp-server"],
      "env": {
        "SOLIDTIME_API_TOKEN": "your-token-here",
        "SOLIDTIME_ORGANIZATION_ID": "your-org-uuid-here",
        "SOLIDTIME_API_URL": "https://your-instance.example.com"
      }
    }
  }
}

Claude代码配置

添加到您的 .mcp.json:

{
  "mcpServers": {
    "solidtime": {
      "command": "npx",
      "args": ["-y", "solidtime-mcp-server"],
      "env": {
        "SOLIDTIME_API_TOKEN": "your-token-here",
        "SOLIDTIME_ORGANIZATION_ID": "your-org-uuid-here",
        "SOLIDTIME_API_URL": "https://your-instance.example.com"
      }
    }
  }
}

工具

时间条目（8个工具）

工具 说明
solidtime_start_timer 启动正在运行的计时器（首先检查现有的活动计时器）
solidtime_stop_timer 停止活动计时器
solidtime_get_active_timer 获取当前正在运行的计时器
solidtime_list_time_entries 列出带有过滤器的条目（日期范围、项目、客户、标签、计费）
solidtime_create_time_entry 创建一个包含开始和结束时间的完整条目
solidtime_update_time_entry 更新现有条目的任何字段
solidtime_delete_time_entry 永久删除条目
solidtime_get_time_entry_report 按天/周/月/项目/客户等汇总报告。

项目（4个工具）

工具 说明
solidtime_list_projects 列出所有项目（按存档状态筛选）
solidtime_create_project 创建一个包含名称、颜色和计费费率的项目
solidtime_update_project 更新项目字段
solidtime_delete_project 永久删除项目

客户端（3个工具）

工具 说明
solidtime_list_clients 列出所有客户端（按存档状态筛选）
solidtime_create_client 创建客户端
solidtime_update_client 更新客户名称

标签（3个工具）

工具 说明
solidtime_list_tags 列出所有标签
solidtime_create_tag 创建标签
solidtime_update_tag 更新标签的名称

任务（3个工具）

工具 说明
solidtime_list_tasks 列出任务（按项目、完成状态筛选）
solidtime_create_task 在项目中创建任务
solidtime_update_task 更新任务名称、完成状态或估计时间

用户（1个工具）

工具 说明
solidtime_get_current_user 获取您的用户资料和已解析的成员ID

使用示例

开始跟踪时间：

“为网站重新设计项目启动计时器”

记录已完成的工作：

“为API项目创建今天9:00-11:30的时间条目，标记为开发”

获取每周报告：

“显示按项目分组的本周工时报告”

检查正在运行的内容：

“有计时器在运行吗？”

故障排除

“身份验证失败”

你的 SOLIDTIME_API_TOKEN 无效或已过期。在SolidTime中的“设置”>“API”下生成一个新的。

“权限被拒绝”

您的令牌无权访问指定的组织。验证 SOLIDTIME_ORGANIZATION_ID.

“无法达到SolidTime”

检查一下 SOLIDTIME_API_URL 正确且实例可访问。对于自托管：确保URL包含协议（例如。， https://solidtime.example.com).

“找不到用户的成员”

经过身份验证的用户不是指定组织的成员。检查 SOLIDTIME_ORGANIZATION_ID.

发展

git clone https://github.com/SwamiRama/solidtime-mcp-server.git
cd solidtime-mcp-server
npm install
npm run dev          # Run with tsx (dev mode)
npm run build        # Compile TypeScript
npm run lint         # ESLint
npm run typecheck    # Type checking
npm run inspector    # Test with MCP Inspector

许可证

麻省理工学院

相关 MCP