Jira 9.12.14 MCP Server

基本能力

产品定位

Jira 9.12.14 MCP Server 是一个为 Jira API 实现的模型上下文协议服务器，旨在为 AI 模型提供与 Jira 交互的安全通道。

核心功能

• JQL Search: 执行 JQL 查询以在 Jira 中查找问题
• Get Issue: 通过 ID 或 key 检索特定问题的详细信息

适用场景

• 自动化 Jira 问题查询
• 集成 Jira 功能到 AI 工作流中
• 开发与 Jira 交互的自动化工具

工具列表

1. JQL Search (mcp_jira_jql_search): 执行 JQL 查询以查找 Jira 中的问题。
2. 参数: jql(必需), fields(可选), maxResults(可选), startAt(可选), expand(可选)
3. Get Issue (mcp_jira_get_issue): 通过 ID 或 key 检索特定问题的详细信息。
4. 参数: issueIdOrKey(必需), fields(可选), expand(可选), properties(可选), failFast(可选)

常见问题解答

• 如果遇到 JIRA_API_URL environment variable is required 错误，请确保：
• 在运行服务器的目录中创建了 .env 文件，或者
• 在 Claude for Desktop 配置中提供了 MCP_JIRA_API_URL 和 MCP_JIRA_AUTH_TOKEN

使用教程

使用依赖

• Node.js (v16 或更高版本)
• npm 或 yarn
• Jira 实例
• Jira API 的认证凭证

安装教程

选项 1: 使用 npx (推荐)

# 创建配置目录
mkdir jira-mcp && cd jira-mcp

# 创建 .env 文件
cat > .env << EOL
JIRA_API_URL=https://your-domain.atlassian.net
JIRA_AUTH_TOKEN=your-token-here
EOL

# 直接运行服务器
npx @andrewyun/jira-9-12-14-mcp-server

选项 2: 手动安装

1. 克隆仓库
2. 安装依赖:

npm install

1. 构建项目:

npm run build

调试方式

运行服务器

npm start

与 Claude for Desktop 集成

1. 打开 Claude for Desktop App 配置文件
2. 添加服务器配置:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/jira-9.12.14-mcp-server/dist/index.js"
      ],
      "env": {
        "MCP_JIRA_API_URL": "https://your-domain.atlassian.net",
        "MCP_JIRA_AUTH_TOKEN": "your-jira-token"
      }
    }
  }
}

替换 /ABSOLUTE/PATH/TO/ 为服务器在您系统上的实际路径。

许可证

该项目遵循 MIT 开源许可条款。