Jira Tempo时间跟踪——MCP服务器
MCP（模型上下文协议）服务器，为Cursor和其他MCP兼容客户端中的AI代理提供Jira Tempo时间跟踪工具。
您无需键入CLI命令，而是自然地询问代理——“今天在PROJ-123上记录2小时”——它会自动调用正确的工具。
工具
| 工具 | 说明 |
|---|---|
log_time | 记录单个Jira问题的时间 |
bulk_log_time | 同时记录多个问题的时间 |
list_issues | 列出Jira问题（分配的、最近的或按项目） |
time_summary | 查看每日总计的记录时间（今天、本周或自定义范围） |
team_worklogs | 显示下属的工作日志（您领导的Tempo团队） |
设置
1.安装依赖项
cd time-tracker
npm install2.获取您的API代币
| 令牌 | 来源 |
|---|---|
| Jira API代币 | Atlassian API代币 |
| Tempo API令牌 | Tempo>设置>API集成 |
3.配置您的MCP客户端
凭据在MCP客户端配置中作为环境变量传递。服务器在启动时读取它们，并自动检测您的Jira帐户ID。
光标
编辑 .cursor/mcp.json 在项目根目录中（已包含）：
{
"mcpServers": {
"jira-tempo": {
"command": "npx",
"args": ["tsx", "src/index.ts"],
"cwd": "/path/to/time-tracker",
"env": {
"JIRA_BASE_URL": "https://yourcompany.atlassian.net",
"JIRA_EMAIL": "you@company.com",
"JIRA_API_TOKEN": "your-jira-api-token",
"TEMPO_API_TOKEN": "your-tempo-api-token"
}
}
}
}克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"jira-tempo": {
"command": "/path/to/time-tracker/run-server.sh",
"args": [],
"env": {
"JIRA_BASE_URL": "https://yourcompany.atlassian.net",
"JIRA_EMAIL": "you@company.com",
"JIRA_API_TOKEN": "your-jira-api-token",
"TEMPO_API_TOKEN": "your-tempo-api-token"
}
}
}
}4.重新启动客户端
重新启动Cursor或Claude Desktop。工具将自动显示。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
JIRA_BASE_URL | 是 | Jira Cloud URL，例如。 https://company.atlassian.net |
JIRA_EMAIL | 是 | 用于登录Jira的电子邮件 |
JIRA_API_TOKEN | 是 | Jira API令牌 |
TEMPO_API_TOKEN | 是 | Tempo API令牌 |
JIRA_ACCOUNT_ID | 否 | 启动时通过Jira API自动检测 |
使用示例
配置后，只需与代理交谈：
- “今天在PROJ-123上记录2小时” --电话
log_time - “2026年2月9日，记录4小时到PROJ-100，4小时到PROJ-200” --电话
bulk_log_time - “显示我分配的Jira问题” --电话
list_issues - “显示我本周的时间摘要” --电话
time_summary - “显示我的团队上周的工作日志” --电话
team_worklogs
项目结构
src/
index.ts MCP server entry point (stdio transport)
config.ts Read credentials from environment variables
jira-client.ts Jira Cloud REST API v3 wrapper
tempo-client.ts Tempo Cloud REST API v4 wrapper
utils.ts Duration parsing, date helpers
tools/
log-time.ts "log_time" tool
bulk-log.ts "bulk_log_time" tool
list-issues.ts "list_issues" tool
summary.ts "time_summary" tool
team-worklogs.ts "team_worklogs" tool技术栈
- TypeScript + Node.js v22
- @模型上下文协议/sdk v1.x——官方MCP SDK
- 佐德 --输入模式验证
- stdio传输 --Cursor/Claude桌面原生MCP通信
需求
- Node.js>=18
- 带有Tempo时间表的Jira Cloud实例
- Jira API代币+Tempo API代币