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).

1. 创建至少一个样本问题（例如。， KAN-1)用于测试。

______________________________________________________________________

🔑 步骤2：生成Jira API令牌

1. 访问 [大西洋API

代币](https://id.atlassian.com/manage-profile/security/api-tokens).

1. 点击 创建API令牌 → 命名它（例如。， *MCP服务器令牌*).
2. 复制生成的令牌——您将把它添加到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//mcp-jira-server/mcp_jira_server.py\\

1. 检查环境变量(HOME, PATH, SHELL).\\
2. 点击 重启 → 状态应显示 连接.

______________________________________________________________________

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集成成功！ 🎉

______________________________________________________________________