Jira MCP 服务器（基于 MCP 协议的 Jira 集成后端）

关键词

Jira 集成AI 助手上下文管理多传输协议

使用说明

  • 项目简介

    • 该服务实现了基于 MCP 的后端，专门将 Jira 的信息、操作工具以及可渲染的提示模板暴露给 MCP 客户端，用于在 AI 应用中以结构化、可扩展的方式访问 Jira 数据和功能。

  • 主要功能点

    • 资源、工具与提示模板的统一访问：提供 Jira 问题、项目、组件等数据的资源入口，并实现可调用的工具（如查询、创建、更新、评论、链接等）。
    • 多传输协议支持：支持 STDIO（默认）和 SSE（HTTP 传输），可与不同的 MCP 客户端进行集成。
    • 会话与权限管理：通过配置管理 Jira 连接信息，进行会话管理和能力声明，确保对 Jira 的访问是经过配置和受控的。
    • 数据模型与校验：使用 Pydantic 提供结构化的数据模型，确保输入输出的一致性与可预测性。
    • 动态配置和团队/组件别名管理：允许运行时管理团队、组件别名等配置，提升使用灵活性。

  • 安装步骤

    • 获取代码并安装依赖：
      • 将仓库克隆到本地
      • 使用 Python 环境安装并开启本地运行环境
    • 运行方式（两种传输模式任选其一）：
      • STDIO（默认）：通过命令直接启动服务器，例如运行 python -m jira_mcp_server.main
      • SSE（HTTP）：通过命令运行 jira-mcp-server --transport sse，并按需要指定主机与端口
    • 依赖说明
      • 需要安装 MCP 相关依赖（如 fastmcp 等库）以及 Jira 客户端依赖，确保 Python 环境可正常导入并与 Jira 实例通信。

  • 服务器配置（MCP 客户端如何接入该 MCP 服务器的配置说明，供 MCP 客户端使用的 JSON 配置示例描述）

    • MCP 客户端需要一个包含服务器信息的配置项，用以启动与连接服务器。该配置文件本身不是服务器代码的一部分，但用于 MCP 客户端在本地或团队环境中发现并启动服务器。
    • 配置字段（示意，非代码）：
      • server name：例如 jira-production，表示一个可被客户端识别的服务器实例名称
      • command：启动服务器的命令，例如 python
      • args：启动参数，例如 ["-m", "jira_mcp_server.main"]
      • cwd（可选）：服务器工作目录，例如项目根目录的路径
      • env（可选）：环境变量映射，用于设置 Jira 目标实例的 URL、认证信息等
    • 说明：实际运行时，服务器端的配置信息由 Jira 连接设置决定，客户端配置仅用于定位和启动服务器进程；客户端本身无需了解服务器内部实现细节。

  • 基本使用方法

    • 启动方式
      • STDIO： python -m jira_mcp_server.main
      • SSE： jira-mcp-server --transport sse
    • 与 MCP 客户端的交互方式
      • 客户端通过 MCP 协议调用服务器暴露的工具（如 search_issues、get_issue 等），服务器返回结构化的 JSON 响应。
      • 服务器支持对 Jira 的异步操作、队列化限速以及并发调用的控制，确保对 Jira API 的友好访问。
    • 常见工作流
      • 在 AI 应用中通过工具接口查询 Jira 问题、创建/更新问题、添加评论、分配团队等。
      • 使用资源入口获取格式化的 Jira 事项、项目信息等，作为后续对话的上下文信息。

服务器信息

访问项目