AI导哈

Jira集成工具

一个Python基础的MCP服务器，用于连接Jira Cloud社区实例并通过MCP Inspector进行测试和验证。

  • by sathishsec2563
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sathishsec2563/MCP-Jira-Server--MCP-inspector

使用说明

🧰 MCP Jira服务器和MCP检查器设置指南

🎯 目标

设置并测试连接到Jira Cloud的基于Python的MCP服务器 使用MCP检查器的社区实例。

🧩 先决条件

  • macOS（在macOS Sonoma或更新版本上测试）
  • Python 3.11+
  • Node.js v22.7.5或更高版本
  • MCP检查器v0.17.2
  • Jira云社区实例
  • Atlassian的API令牌

⚙️ 步骤1：创建Jira社区实例

  1. 首选 Atlassian Jira.
  2. 创建或登录您的Jira Cloud社区实例（例如。， myteam.atlassian.net).
  3. 创建至少一个样本问题（例如。， KAN-1)用于测试。

🔑 步骤2：生成Jira API令牌

  1. 访问 大西洋API 代币.
  2. 点击 创建API令牌 → 命名它（例如。， MCP服务器令牌).
  3. 复制生成的令牌——您将把它添加到Python脚本中。

🐍 步骤3：设置并运行Python MCP服务器

cd mcp_jira_server
python3 -m venv venv
source venv/bin/activate
pip install fastmcp requests

编辑 mcp_jira_server.py:

JIRA_DOMAIN = "your-domain.atlassian.net"
JIRA_EMAIL = "your-email@example.com"
JIRA_API_TOKEN = "your-api-token"

运行服务器：

python mcp_jira_server.py

预期产量：

🚀 Starting MCP Jira Server ...
Connecting to https://your-domain.atlassian.net as your-email@example.com

🧠 步骤4：验证服务器是否正在运行

检查服务器启动时是否没有错误。
它应该保持运行并显示连接日志。

🧩 步骤5：安装并启动MCP检查器

node -v
npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector

预期产量：

⚙️ Proxy server listening on localhost:6277
🔑 Session token: b94156657...
🌐 MCP Inspector is up and running at:
   http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=b94156657...

🖥️ 步骤6：打开MCP检查器UI

单击提供的localhost链接---检查器将在您的 浏览器。

🧩 步骤7：配置MCP检查器连接

7.1创建STDiO连接

  1. 运输类型： STDiO
  2. 命令： python3\
  3. 论据： /Users/<yourusername>/mcp-jira-server/mcp_jira_server.py\
  4. 检查环境变量(HOME, PATH, SHELL).\
  5. 点击 重启 → 状态应显示 连接.

7.2验证连接和运行工具

  1. 首选 工具 tab → click 列出工具.\
  2. 选择 get_jira_issue 并输入Jira问题ID（例如。， KAN-4).\
  3. 点击 运行工具.\
  4. Jira的JSON响应应该出现。

例子：

{
  "id": "KAN-4",
  "fields": {
    "summary": "Sample Jira Issue",
    "status": { "name": "To Do" }
  }
}

7.3确认服务器输出

在启动MCP服务器的终端中：

🚀 Starting MCP Jira Server ...
Connecting to https://your-domain.atlassian.net as your-email@example.com

🧯 故障排除

问题可能解决

401未经授权的验证 JIRA_EMAIL 和 JIRA_API_TOKEN 是 对的。

模块故障：运行 pip install fastmcp requests. fastmcp

✅ 确认

当：-MCP检查器显示 Connected -工具清单包括 get_jira_issue -JSON输出返回Jira问题数据

✅ 您的MCP-Jira集成成功！ 🎉

相关 MCP