节奏-MCP服务器

Name: 节奏-MCP服务器
Author: ivelin-web

作者：ivelin-web25 星标更新：2025-11-04

安装使用来源：spider==github.com

项目介绍

Tempo MCP 服务器

一个用于管理 Jira 中 Tempo 工作日志的模型上下文协议（MCP）服务器。该服务器提供了通过 Tempo 的 API 跟踪时间和管理工作日志的工具，使其可以通过 Claude、Cursor 和其他兼容 MCP 的客户端访问。

功能

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

系统需求

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

使用选项

有两种主要方式使用此 MCP 服务器：

NPX（推荐大多数用户）：无需安装直接运行
本地克隆：克隆仓库进行开发或定制

选项 1：NPX 使用

最简单的方式是通过 npx 无需安装来使用此服务器：

连接到 Claude Desktop（NPX 方法）

打开您的 MCP 客户端配置文件：
- Claude Desktop（macOS）：~/Library/Application Support/Claude/claude_desktop_config.json
- Claude Desktop（Windows）：%APPDATA%\Claude\claude_desktop_config.json
添加以下配置：

{
  "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": "your_email@example.com",
        "JIRA_BASE_URL": "https://your-org.atlassian.net"
      }
    }
  }
}

重启您的 Claude Desktop 客户端

Cursor 的一键安装

选项 2：本地仓库克隆

安装

# 克隆仓库
git clone https://github.com/ivelin-web/tempo-mcp-server.git
cd tempo-mcp-server

# 安装依赖
npm install

# 构建 TypeScript 文件
npm run build

本地运行

有两种方法可以本地运行服务器：

1. 使用 MCP Inspector（用于开发和调试）

npm run inspect

2. 直接使用 Node

您可以直接用 Node 运行服务器，指向构建的 JavaScript 文件：

连接到 Claude Desktop（本地方法）

打开您的 MCP 客户端配置文件
添加以下配置：

{
  "mcpServers": {
    "Jira_Tempo": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/tempo-mcp-server/build/index.js"],
      "env": {
        "TEMPO_API_TOKEN": "your_tempo_api_token_here",
        "JIRA_API_TOKEN": "your_jira_api_token_here",
        "JIRA_EMAIL": "your_email@example.com",
        "JIRA_BASE_URL": "https://your-org.atlassian.net"
      }
    }
  }
}

重启您的 Claude Desktop 客户端

获取 API 令牌

Tempo API 令牌：
- 前往 Tempo > 设置 > API 集成
- 创建一个新的具有适当权限的 API 令牌
Jira API 令牌：
- 前往 Atlassian API 令牌
- 为您账户创建一个新的 API 令牌

环境变量

服务器需要以下环境变量：

TEMPO_API_TOKEN     # 您的 Tempo API 令牌
JIRA_API_TOKEN      # 您的 Jira API 令牌
JIRA_EMAIL          # 您的 Jira 账户电子邮件
JIRA_BASE_URL       # 您的 Jira 实例 URL（例如，https://your-org.atlassian.net）
JIRA_TEMPO_ACCOUNT_CUSTOM_FIELD_ID     # 可选：Temo 账户的自定义字段 ID

您可以在环境中设置这些变量，或者在 MCP 客户端配置中提供它们。

Tempo 账户配置

如果您的 Tempo 实例需要将工作日志链接到账户，请设置包含账户信息的自定义字段 ID：

JIRA_TEMPO_ACCOUNT_CUSTOM_FIELD_ID=10234

要找到您的自定义字段 ID：

前往 Jira 设置 → 问题 → 自定义字段
查找您的 Tempo 账户字段，并从 URL 或字段配置中记下 ID

可用工具

retrieveWorklogs

获取配置用户之间开始和结束日期的工作日志。

参数：
- startDate: 字符串（YYYY-MM-DD）
- endDate: 字符串（YYYY-MM-DD）

createWorklog

为特定的 Jira 问题创建新的工作日志。

参数：
- issueKey: 字符串（例如，“PROJECT-123”）
- timeSpentHours: 数字（正数）
- date: 字符串（YYYY-MM-DD）
- description: 字符串（可选）
- startTime: 字符串（HH:MM 格式，可选）

bulkCreateWorklogs

一次操作创建多个工作日志。

参数：
- worklogEntries: 数组，每个元素包含：
    issueKey: 字符串
    timeSpentHours: 数字
    date: 字符串（YYYY-MM-DD）
    description: 字符串（可选）
    startTime: 字符串（HH:MM 格式，可选）

editWorklog

修改现有的工作日志。

参数：
- worklogId: 字符串
- timeSpentHours: 数字（正数）
- description: 字符串（可选）
- date: 字符串（YYYY-MM-DD，可选）
- startTime: 字符串（HH:MM 格式，可选）

deleteWorklog

移除现有的工作日志。

参数：
- worklogId: 字符串

项目结构

tempo-mcp-server/
├── src/                  # 源代码
│   ├── config.ts         # 配置管理
│   ├── index.ts          # MCP 服务器实现
│   ├── jira.ts           # Jira API 集成
│   ├── tools.ts          # 工具实现
│   ├── types.ts          # TypeScript 类型和模式
│   └── utils.ts          # 工具函数
├── build/                # 编译的 JavaScript（生成）
├── tsconfig.json         # TypeScript 配置
└── package.json          # 项目元数据和脚本

故障排除

如果您遇到问题：

检查所有环境变量是否正确设置
验证您的 Jira 和 Tempo API 令牌是否有正确的权限
检查控制台输出中的错误消息
尝试使用 inspector 运行：npm run inspect

许可证

MIT

致谢

此服务器实现了由 Anthropic 创建的模型上下文协议规范。