solidtime mcp服务器
  ](https://www.npmjs.com/package/solidtime-mcp-server)
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许可证
麻省理工学院