Tempo MCP Server

基本能力

产品定位

Tempo MCP Server 是一个用于管理 Jira 中 Tempo 工作日志的 MCP 服务器，旨在通过 MCP 兼容客户端提供时间跟踪和工作日志管理功能。

核心功能

• 检索工作日志：获取特定日期范围内的所有工作日志
• 创建工作日志：为 Jira 问题记录时间
• 批量创建：在单个操作中创建多个工作日志
• 编辑工作日志：修改时间花费、日期和描述
• 删除工作日志：移除现有的工作日志

适用场景

• 团队协作中的时间跟踪
• Jira 项目管理中的工作日志管理
• 通过 MCP 兼容客户端（如 Claude、Cursor）访问 Tempo 功能

工具列表

• retrieveWorklogs：获取配置用户在开始和结束日期之间的工作日志
• createWorklog：为特定 Jira 问题创建新的工作日志
• bulkCreateWorklogs：在单个操作中创建多个工作日志
• editWorklog：修改现有的工作日志
• deleteWorklog：移除现有的工作日志

常见问题解答

1. 检查所有环境变量是否正确设置
2. 验证 Jira 和 Tempo API 令牌是否具有正确的权限
3. 检查控制台输出以获取错误消息
4. 尝试使用检查器运行：npm run inspect

使用教程

使用依赖

• Node.js 18+（推荐 LTS）
• Jira Cloud 实例
• Tempo API 令牌
• Jira API 令牌

安装教程

NPX 使用（推荐大多数用户）

1. 打开 MCP 客户端配置文件
2. Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
3. Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
4. 添加以下配置：

{
  "mcpServers": {
    "Jira_Tempo": {
      "command": "npx",
      "args": [
        "-y",
        "@ivelin-web/tempo-mcp-server"
      ],
      "env": {
        "TEMPO_API_TOKEN": "your_tempo_api_token_here",
        "JIRA_API_TOKEN": "your_jira_api_token_here",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_BASE_URL": "https://your-org.atlassian.net"
      }
    }
  }
}

1. 重启 Claude Desktop 客户端

本地仓库克隆

1. 克隆仓库

git clone https://github.com/ivelin-web/tempo-mcp-server.git
cd tempo-mcp-server

1. 安装依赖

npm install

1. 构建 TypeScript 文件

npm run build

调试方式

使用 MCP 检查器（用于开发和调试）

npm run inspect

使用 Node 直接运行

node /ABSOLUTE/PATH/TO/tempo-mcp-server/build/index.js

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。