关键词

Jira Tempo工时管理项目管理LLM集成智能自动化

项目简介

'jira-tempo' 仓库提供了一个基于 Spring AI 的 Model Context Protocol (MCP) 服务器实现。它的核心功能是将 Atlassian Jira 生态系统中的时间跟踪和工时管理插件 Jira Tempo 的各项功能，转化为可被大语言模型 (LLM) 调用的工具。这意味着 LLM 客户端可以通过标准化的 MCP 协议，智能地访问、查询和操作 Jira Tempo 中的工时记录、项目信息等，从而实现更智能的工作流自动化。

主要功能点

  • Jira Tempo 功能集成： 将 Jira Tempo 的核心功能（如记录工时、查询工作日志、管理项目工作项等）封装为 LLM 可理解和调用的工具，扩展 LLM 的实际操作能力。
  • MCP 协议支持： 完全符合 MCP 协议规范，支持 SSE (Server-Sent Events) 和 Streamable HTTP 两种传输协议，确保与各类 MCP 客户端（如 Claude AI 助手）实现高效、稳定的通信。
  • 工具声明与暴露： 作为 MCP 服务器，它负责声明并暴露其提供的 Jira Tempo 相关工具集，允许 LLM 客户端发现这些工具，并在需要时智能地调用它们来执行特定任务，例如让 LLM 自动为某个任务记录工时。

安装步骤

本服务是一个基于 Java 和 Gradle 构建的 Spring Boot 应用。

  1. 克隆仓库： 打开终端或命令行工具，执行以下命令获取项目代码： 
    git clone https://github.com/michalkowol/jira-tempo.git
  2. 进入项目目录： 
    cd jira-tempo
  3. 构建项目： 运行 Gradle 命令编译代码并运行测试。此步骤会生成可执行的 JAR 文件。 
    ./gradlew clean check
  4. 运行服务器： 启动 Spring Boot 应用程序，它将作为 MCP 服务器运行，默认监听在 'http://localhost:8080' 端口。 
    ./gradlew bootRun

服务器配置

要将此 'jira-tempo' MCP 服务器连接到您的 MCP 客户端（例如 Claude AI 助手），您需要提供以下连接信息。MCP 客户端将使用这些信息来发现并与 'jira-tempo' 服务所提供的 Jira Tempo 工具建立连接。

以下是一个推荐的 MCP 客户端配置信息示例（JSON 格式），请注意其中的参数注释：

{
  "name": "JiraTempo服务",
  "command": "java",
  "args": [
    "-jar",
    "path/to/your/jira-tempo-application.jar", // 请替换为实际的jar包路径
    "--spring.ai.mcp.server.protocol=streamable",
    "--spring.ai.mcp.server.streamable-http.mcp-endpoint=/mcp"
  ],
  "description": "通过MCP协议提供Jira Tempo的时间跟踪和项目管理工具。",
  "transport": "http",
  "endpoint": "http://localhost:8080/mcp"
}

配置参数注释：

  • 'name': 服务器的显示名称，用于在您的 MCP 客户端中标识此 Jira Tempo 服务。
  • 'command': 用于启动 'jira-tempo' 服务器应用程序的可执行命令，这里是 'java'。
  • 'args': 启动 'jira-tempo' 服务器时传递给 'java' 命令的参数列表。
    • 'path/to/your/jira-tempo-application.jar': 重要提示： 请务必将其替换为你在项目 'build/libs' 目录下实际生成的 'jira-tempo-*.jar' 文件的完整路径。例如，如果文件是 'jira-tempo-0.0.1-SNAPSHOT.jar'，路径可能是 '/home/user/jira-tempo/build/libs/jira-tempo-0.0.1-SNAPSHOT.jar'。
    • '--spring.ai.mcp.server.protocol=streamable': 指定 MCP 服务器使用 'streamable' 协议进行通信。
    • '--spring.ai.mcp.server.streamable-http.mcp-endpoint=/mcp': 指定 MCP 服务器的 'streamable' 协议端点路径为 '/mcp'。
  • 'description': 对此 MCP 服务器功能的简短描述，帮助您或LLM客户端理解其作用。
  • 'transport': 传输协议类型，这里指定为 'http'，对应 'streamable-http' 协议。
  • 'endpoint': MCP 服务器的完整访问地址。这是 LLM 客户端将用于与 'jira-tempo' 服务通信的 URL。

基本使用方法

  1. 首先，按照上述“安装步骤”中的说明，在您的本地环境成功启动 'jira-tempo' MCP 服务器。确保它正在运行且可通过 'http://localhost:8080' 访问。
  2. 然后，使用您的 MCP 客户端工具（例如，通过 'claude mcp add' 命令或相应界面的配置选项），添加上述“服务器配置”信息。例如，如果使用 'claude' 命令行工具： 
    claude mcp add --scope user --transport http "JiraTempo服务" http://localhost:8080/mcp
  3. 一旦 MCP 客户端成功连接并发现 'jira-tempo' 服务器所暴露的工具，您的 LLM 即可开始智能地利用这些工具。您可以向 LLM 发出自然语言请求，例如：“帮我在 Jira 上为任务 XYZ 记录 2 小时工时”，或者“查询我今天在项目 ABC 上的所有工时记录”，LLM 将通过调用 'jira-tempo' 服务提供的相应 MCP 工具来执行这些操作。具体的工具调用方式和能力取决于您的 LLM 和 MCP 客户端的集成程度。

信息

分类

商业系统

访问项目