返回 MCP 目录
public公开dns本地运行

mcp-jira-server-bhx

一个与Jira集成的MCP服务器,用于问题管理,支持创建、读取、更新Jira问题,搜索问题,史诗管理和个人问题跟踪等功能。

article

README

🚀 MCP Jira 服务器

MCP Jira 服务器是一个集成了 Jira 的问题管理服务器,它能够帮助用户高效地进行问题管理,提升工作效率。

演示视频

Sooraj Chandran 编码

🚀 快速开始

准备工作

在开始使用 MCP Jira 服务器之前,你需要满足以下先决条件:

  • Python 3.8+
  • 带 API 访问权限的 Jira 账号
  • Jira API 令牌

安装与配置

选项 1

克隆仓库,让 Cursor(或你的 IDE)查看 README.md 并一直运行命令直到成功。

选项 2

  1. 克隆仓库:将项目仓库克隆到本地。

  2. 创建虚拟环境

    python -m venv venv
    source venv/bin/activate  # 在 Windows 上:venv\Scripts\activate
    
  3. 安装依赖项

    pip install -r requirements.txt
    
  4. 复制并配置环境文件

    cp .env.example .env
    

    编辑 .env 文件,使用你的 Jira 配置:

    • JIRA_SERVER:你的 Jira 实例 URL
    • JIRA_USER:你的 Jira 邮箱
    • JIRA_TOKEN:你的 Jira API 令牌
    • JIRA_TIMEOUT:API 超时时间(默认:30 秒)
    • JIRA_MAX_RESULTS:每页最大结果数(默认:50)
    • MCP_SERVER_PORT:服务器端口(默认:8000)

    ⚠️ 重要提示

    你需要在 src 文件夹中创建一个静态文件夹。

运行服务器

python src/main.py

服务器将在 http://localhost:8000 上运行

✨ 主要特性

  • Jira 问题管理:支持创建、读取、更新 Jira 问题。
  • 问题搜索:可以快速搜索所需问题。
  • 故事与子任务管理:方便进行故事管理与子任务处理。
  • 个人问题跟踪:帮助用户跟踪个人问题。

📦 其他用例

本服务器还支持从 PRD 创建问题,进一步拓展了其使用场景。

🔧 安全注意事项

  • 永远不要提交你的 .env 文件,防止敏感信息泄露。
  • 保护好你的 Jira API 令牌,避免被他人获取。
  • 在生产环境中使用 HTTPS,确保数据传输安全。
  • 考虑为 API 端点实现额外的身份验证,增强系统安全性。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端