项目简介
Tempo MCP 服务器是一个基于Model Context Protocol (MCP) 实现的应用后端,专为管理Jira中的Tempo工作日志而设计。它允许与MCP兼容的LLM客户端(如Claude, Cursor)通过标准化的方式访问Tempo API,执行工作日志相关的操作。
主要功能点
- 查看工作日志: 获取指定日期范围内当前用户的所有工作日志。
- 创建工作日志: 为特定的Jira事项记录新的工作时间。
- 批量创建工作日志: 在一次操作中创建多个工作日志条目。
- 编辑工作日志: 修改现有工作日志的时间、日期和描述。
- 删除工作日志: 移除现有的工作日志条目。
安装步骤
该服务器可以通过两种主要方式运行:
- 使用 NPX (推荐): 这是最简单的方式,无需全局安装。确保已安装 Node.js 18+。
- 本地克隆: 如果您需要进行开发或定制,可以克隆仓库并手动安装依赖。需要 Node.js 18+。
# 克隆仓库 git clone https://github.com/ivelin-web/tempo-mcp-server.git cd tempo-mcp-server # 安装依赖 npm install # 构建 TypeScript 文件 npm run build
服务器配置
MCP服务器通常由MCP客户端启动和管理。为了让您的LLM客户端能够使用此服务器,您需要在客户端的配置中添加相应的条目。
配置信息将包含一个名称(如'Jira_Tempo'),以及客户端启动服务器所需的命令和参数。此外,您还需要在配置中或系统环境中提供访问 Tempo 和 Jira API 所需的凭证和信息,通常以环境变量的形式传递:
- 'TEMPO_API_TOKEN': 您的 Tempo API 令牌。
- 'JIRA_API_TOKEN': 您的 Jira API 令牌。
- 'JIRA_EMAIL': 与您的 Jira 账户关联的电子邮件地址。
- 'JIRA_BASE_URL': 您的 Jira 实例的基础URL(例如,'https://your-org.atlassian.net')。
具体的配置格式取决于您使用的MCP客户端。例如,对于支持本地MCP服务器的客户端,您会指定启动命令(如'npx'或本地构建后的'node'路径)、参数(如'@ivelin-web/tempo-mcp-server'或'/path/to/build/index.js')以及上述环境变量。
基本使用方法
在您的MCP客户端(如Claude Desktop)中完成服务器配置并重启客户端后,LLM将能够感知并使用此服务器提供的工具。您可以直接向LLM提出与Jira Tempo工作日志相关的请求,例如:
- “请帮我查一下我昨天记录的所有工作日志。”
- “我想为事项 PROJECT-123 记录 3 小时的工作时间,内容是完成需求分析。”
- “把我事项 TASK-456 今天记录的 4 小时工作日志改成 5 小时。”
LLM会根据您的指令自动调用Tempo MCP服务器提供的相应工具来执行操作。
信息
分类
生产力应用