Token导航 LogoToken导航TokenDH.com
中转站排行榜
BMAD JIRA Integration Documentation MCP Server logo
AI代理stdio官方级别未说明来源级核验

BMAD JIRA Integration Documentation MCP Server

MCP Server

@aashari/mcp-server-atlassian-jira

Jira MCP服务器集成是一个标准化AI代理连接Jira的工具，支持BMAD敏捷开发方法，包含完整的开发工作流、Jira问题创建和管理、GitHub PR集成等功能。

工具数

0

提示词数

0

GitHub Stars

1

资源数

0
Jira集成工作流管理JavaScriptAI代理

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

作者 / 组织

BinaryVortex

提供方

BinaryVortex

最后核验

2026/5/17 20:22

运行时

Node.js

快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

npx @aashari/mcp-server-atlassian-jira --help

详细介绍

BMAD JIRA集成文档MCP服务器

Jira MCP服务器设置和BMAD集成指南

本综合指南展示了如何使用我们今天构建的BMAD（敏捷开发业务方法论）集成复制完整的Jira MCP（模型上下文协议）服务器设置。

🎯 我们今天建造了什么

  • ✅ Jira MCP服务器集成 -与Jira的标准化AI代理连接
  • ✅ BMAD看板工作流程 -使用Jira跟踪完成开发工作流程
  • ✅ 真正的Jira问题创建 -KAN-39、KAN-40、KAN-41的创建和管理
  • ✅ 带有黑暗模式的Todo应用程序 -具有Jira同步功能的全功能React应用程序
  • ✅ 多个工作流演示 -高级过滤、暗模式、电子商务规划
  • ✅ GitHub公关集成 -自动创建和链接PR

📋 先决条件

  • 已安装Node.js 18+
  • npm或yarn包管理器
  • 具有API访问权限的Atlassian Jira帐户
  • GitHub帐户（用于PR集成）
  • 终端命令的基本知识

______________________________________________________________________

🚀 步骤1：初始设置和Jira MCP服务器安装

1.1克隆存储库

git clone https://github.com/bmad-code-org/BMAD-METHOD.git
cd BMAD-METHOD

1.2安装全局依赖项

# Install Jira MCP server globally
npm install -g @aashari/mcp-server-atlassian-jira

# Verify installation
npx @aashari/mcp-server-atlassian-jira --help

1.3设置Jira API代币

选项A：创建新的API令牌（推荐）

  1. 首选 https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击“创建API令牌”
  3. 命名它： BMAD MCP Integration
  4. 立即复制令牌（您将不会再看到它！）

选项B：使用现有令牌

  • 确保您现有的令牌仍处于活动状态
  • 记下您的Atlassian站点名称（无 .atlassian.net)

1.4创建MCP配置文件

创建 mcp-config.json 在项目根目录中：

{
    "mcpServers": {
        "atlassian-jira": {
            "command": "npx",
            "args": [
                "@aashari/mcp-server-atlassian-jira"
            ],
            "env": {
                "ATLASSIAN_SITE_NAME": "your-site-name",
                "ATLASSIAN_USER_EMAIL": "your-email@domain.com",
                "ATLASSIAN_API_TOKEN": "your-api-token-here"
            }
        }
    }
}

替换为您的实际值：

  • ATLASSIAN_SITE_NAME：您的Jira站点名称（例如。， disandup6)
  • ATLASSIAN_USER_EMAIL：您的Atlassian帐户电子邮件
  • ATLASSIAN_API_TOKEN：步骤1.3中的API令牌

______________________________________________________________________

🔧 步骤2:MCP客户端包装器设置

2.1安装MCP客户端依赖关系

npm install

2.2测试MCP客户端连接

# Test the MCP client
node test-mcp-client.js

预期产量：

Testing Jira MCP Client...
Found 1 projects:
- KAN: JIRA BMAD INTEGRATION
Found 4 statuses:
- 10000: To Do
- 10001: In Progress
- 10002: In Review
- 10003: Done
✅ MCP Client tests completed successfully!

2.3更新MCP客户端（如果需要）

这 jira-mcp-client.js 该文件包含MCP服务器输出的解析逻辑。如果遇到解析问题，客户端会自动处理来自MCP服务器的markdown格式的响应。

______________________________________________________________________

🛠️ 步骤3：使用Jira集成进行Todo应用程序设置

3.1后端设置

cd todo-app

# Install backend dependencies
npm install

# Create environment file
cp .env.example .env

编辑 .env 文件：

PORT=3001
NODE_ENV=development
JIRA_BASE_URL=https://your-site.atlassian.net
JIRA_EMAIL=your-email@domain.com
JIRA_API_TOKEN=your-api-token-here
GITHUB_TOKEN=your-github-token-here
USE_MCP=true

3.2前端设置

cd frontend

# Install frontend dependencies
npm install

# Remove conflicting Tailwind config (if exists)
rm -f tailwind.config.js

3.3启动应用程序

终端1：后端

cd todo-app
npm start
# Server runs on http://localhost:3001

2号航站楼：前端

cd todo-app/frontend
npm start
# App runs on http://localhost:3000

3.4测试Todo应用程序功能

  1. 打开http://localhost:3000
  2. 测试暗模式：单击标题中的月亮/太阳图标
  3. 测试Jira集成：创建任务并检查Jira板
  4. 测试键盘快捷键:

- Ctrl+/ -切换暗模式 - Ctrl+N -添加新任务 - Ctrl+A -选择所有任务

______________________________________________________________________

🎯 步骤4：运行BMAD看板工作流

4.1测试基本工作流程

# Test MCP connection
node test-mcp-client.js

4.2运行高级过滤工作流

node bmad-kanban-workflow.js

创建： KAN-39（高级过滤和搜索）

4.3运行暗模式工作流

node dark-mode-kanban-workflow.js

创建： KAN-40（暗模式实现）

4.4运行电子商务冲刺计划

node ecommerce-sprint-planning-workflow.js

创建： KAN-41（电子商务冲刺计划）

______________________________________________________________________

📊 步骤5：验证Jira集成

5.1检查您的Jira板

  • 网址： https://your-site.atlassian.net/jira/software/projects/KAN/boards/1
  • 您应该看到问题：KAN-39、KAN-40、KAN-41

5.2验证问题详细信息

每个问题都应该有：

  • ✅ 正确的标题和描述
  • ✅ 状态转换（待办事项→ 进行中→ 审核中→ Done)
  • ✅ 注释中的完成注释
  • ✅ 链接的GitHub PR

5.3直接测试MCP服务器

# List projects
ATLASSIAN_SITE_NAME=your-site ATLASSIAN_USER_EMAIL=your-email ATLASSIAN_API_TOKEN=your-token npx @aashari/mcp-server-atlassian-jira ls-projects --limit 5

# List statuses
ATLASSIAN_SITE_NAME=your-site ATLASSIAN_USER_EMAIL=your-email ATLASSIAN_API_TOKEN=your-token npx @aashari/mcp-server-atlassian-jira ls-statuses

______________________________________________________________________

🔧 步骤6：故障排除

6.1 MCP客户端问题

# If MCP client shows 0 projects
node test-mcp-client.js
# Check your mcp-config.json credentials

6.2 Jira API问题

# Test direct API access
curl -u "your-email:your-token" -X GET "https://your-site.atlassian.net/rest/api/3/project" -H "Accept: application/json"

6.3前端问题

# Clear node_modules and reinstall
cd todo-app/frontend
rm -rf node_modules package-lock.json
npm install

6.4常见错误

“找不到模块'tailwindcss'”

  • 移除 tailwind.config.js 文件
  • 该应用程序使用自定义CSS变量，而不是Tailwind类

“客户端必须经过身份验证”

  • 检查您的API令牌是否有效
  • 验证站点名称不包括 .atlassian.net
  • 确保电子邮件与您的Atlassian帐户匹配

“未找到项目”

  • 验证您是否有权访问Jira中的项目
  • 检查您的实例中是否存在KAN项目

______________________________________________________________________

📁 项目结构

BMAD-METHOD/
├── mcp-config.json                 # MCP server configuration
├── jira-mcp-client.js             # MCP client wrapper
├── test-mcp-client.js             # MCP connection test
├── bmad-kanban-workflow.js        # Advanced filtering workflow
├── dark-mode-kanban-workflow.js   # Dark mode workflow
├── ecommerce-sprint-planning-workflow.js  # Sprint planning workflow
├── todo-app/                      # Main application
│   ├── server.js                  # Express backend
│   ├── services/
│   │   └── jiraService.js         # Jira integration service
│   └── frontend/                  # React frontend
│       ├── src/
│       │   ├── App.js            # Main React component
│       │   └── App.css           # Dark mode styles
│       └── package.json
└── docs/                         # Documentation

______________________________________________________________________

🎨 已实现的功能

✅ MCP集成

  • AI代理的标准化Jira连接
  • 读取操作：项目、问题、状态、评论
  • 写入操作：创建/更新问题，添加注释
  • 混合方法：MCP用于读取，直接API用于写入

✅ Todo应用程序功能

  • 深色模式：完整的主题系统，具有持久性
  • Jira同步：自动创建问题和更新状态
  • 高级过滤：多条件搜索和筛选
  • 批量操作：选择、删除、分类多个任务
  • 键盘快捷键：高级用户功能
  • 响应式设计：移动和桌面优化

✅ BMAD工作流程

  • 看板流程：待办事项→ 进行中→ 审核中→ Done
  • 竣工说明：每项任务的详细审计跟踪
  • GitHub集成：自动创建和链接PR
  • 真正的Jira问题：实际问题创建和管理
  • 透明度：完整的开发过程跟踪

______________________________________________________________________

🔐 安全说明

  • API令牌：从不将令牌提交到版本控制
  • 环境变量：使用 .env 敏感数据文件
  • 访问控制：将Jira项目的访问权限限制为必要的用户
  • 代币轮换：为了安全起见，定期轮换API令牌

______________________________________________________________________

🚀 后续步骤

即时任务

  1. ✅ MCP服务器已配置并测试
  2. ✅ Todo应用程序在黑暗模式下运行
  3. ✅ 看板工作流程产生了真正的Jira问题
  4. ✅ GitHub公关整合工作

Sprint 1（Azure基础架构）

根据我们的电子商务冲刺计划：

  • 设置Azure资源组
  • 配置Azure应用服务
  • 实施Azure AD集成
  • 设置CI/CD管道

高级功能

  • 多租户支持
  • 高级分析仪表板
  • 移动应用开发
  • 基于人工智能的任务建议

______________________________________________________________________

📞 支持

如果您遇到问题：

  1. 检查上面的故障排除部分
  2. 验证您的Jira凭据和权限
  3. 独立测试MCP服务器连接
  4. 检查终端输出是否有特定的错误消息

您的Jira董事会： https://your-site.atlassian.net/jira/software/projects/KAN/boards/1

______________________________________________________________________

🎉 成功检查表

  • \[\]已安装并配置MCP服务器
  • \[\]创建并测试Jira API令牌
  • \[\]MCP客户端包装器正在工作（显示项目/状态）
  • \[\]Todo应用程序后端在端口3001上运行
  • \[\]Todo应用程序前端在端口3000上运行
  • \[\]黑暗模式切换在UI中工作
  • \[\]创建Jira问题的看板工作流程
  • \[\]GitHub PR集成功能
  • \[\]所有功能都经过测试和验证

祝贺 🎉 您现在拥有一个完整的BMAD系统，与Jira MCP集成，就像我们今天构建的一样！

______________________________________________________________________

*文件创建日期：2025年10月31日* *BMAD分析代理-全面设置指南*

/用户/桌面/JIRA MCP/BMAD-METHOD/JIRA-MCP-SETUP-GUIDE.md

目录标签

目录标签

Jira集成工作流管理JavaScriptAI代理本地部署敏捷开发GitHub集成

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

token

运行时（runtime，运行环境）

Node.js

来源包（packageName，安装包名）

@aashari/mcp-server-atlassian-jira

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdiotoken部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

BMAD-JIRA-Integration-Documentation-MCP-Server logo

MCP World

mcpworld.com

/detail/338914e0ac155dd5701f1a4ea1e8fd74

Jira MCP服务器集成是一个标准化AI代理连接Jira的工具，支持BMAD敏捷开发方法，包含完整的开发工作流、Jira问题创建和管理、GitHub PR集成等功能。

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Bmad Agent Fast MCP Service

A professional AI agent system that provides 10+ specialized agents and 25+ MCP tools to support development workflows in Cursor IDE, with dual LLM mode support (built-in and DeepSeek API).

下一个 MCP

bmad MCP

一个轻量级的本地管理器，通过模型上下文协议（MCP）暴露BMAD工具（get_bmad_agent, list_bmad_tasks），为开发者提供程序化访问BMAD代理指令和任务清单的功能。