Jira MCP 服务器

一组用于通过模型上下文协议 (MCP) 与 Jira 交互的工具，提供核心 Jira 功能和统一的、引导式的问题创建和更新向导。

安装

要将其安装到客户端：

{
  "mcpServers": {
    "JiraMCP_Published": {
      "command": "npx",
      "args": [
        "@timbreeding/jira-mcp-server@latest",
        "--jira-base-url=https://example.atlassian.net",
        "--jira-username=someJiraUserEmail@domain.com",
        "--jira-api-token=<your jira token>"
      ],
      "env": {
        "DEBUG": "true",
        "LOG_FILE_PATH": "" // Some full path. If blank, it will not write logs to a file.
      }
    }
  }
}

Related MCP server: JIRA MCP Server

用法

...

配置

环境变量

为了在本地运行，您可以将 DEBUG 和 LOG_FILE_PATH 放入您的 .env 中。

可用工具

此应用程序通过模型上下文协议公开以下工具：

核心 Jira 工具

• getJiraIssue ：通过其密钥获取 Jira 问题。

• analyzeJiraIssue ：对 Jira 问题进行全面分析。

• jiraGet ：从任何 Jira API GET 端点获取数据。

• getIssuesByJql ：使用 JQL 查询搜索 Jira 问题。

问题创建向导工具

这些工具提供了逐步指导的流程，用于创建新的 Jira 问题。向导会在整个创建流程中维护状态，通常涉及以下阶段：启动流程、选择项目 ( getProjects )、选择问题类型 ( getIssueTypes )、检索并填充必要字段（ getFields 、 updateFields ）、选择性地分析问题详情，以及最终确认并创建问题 ( createIssue )。使用getState和getStatus监控进度，使用resetState重新开始。

• issueCreation_getState ：获取向导的当前内部状态。

• issueCreation_getStatus ：获取向导的高级状态。

• issueCreation_initiateState ：初始化一个新的向导状态。

• issueCreation_resetState ：重置向导状态。

• issueCreation_updateState ：更新向导状态（项目、问题类型、字段、步骤）。

• issueCreation_createIssue ：使用向导的状态创建 Jira 问题。

• issueCreation_getProjects ：检索可用的 Jira 项目。

• issueCreation_getIssueTypes ：获取所选项目的可用问题类型。

• issueCreation_getFields ：检索所选项目/问题类型所需的字段。

• issueCreation_updateFields ：更新向导状态中的特定字段值。

• issueCreation_setAnalysisComplete ：设置分析完成标志。

• issueCreation_setUserConfirmation ：在创建之前设置用户确认标志。

• issueCreation_analyzeIssue ：分析向导上下文中的问题详细信息。

发行更新向导工具（统一更新工作流程）

这些工具提供了统一、强大的机制来更新任何 Jira 问题——无论是新创建的还是现有的。现在所有更新都使用统一、一致的工作流程：

• issueUpdateWizard_loadIssueIntoState ：通过关键字获取 Jira 问题并将其加载到状态管理器中以实现统一更新工作流程。

• issueUpdateWizard_updateIssueFromState ：使用当前状态（字段、项目、类型等）更新任何已加载的问题。

关键原则：

• 所有问题更新（新的或现有的）都遵循相同的模式：将问题加载到状态中，修改字段，然后通过 API 更新。

• 新问题更新和现有问题更新之间没有代码重复。

• 最小、明确且强大的错误处理。

• 更新操作的单元测试覆盖率为 100%。

发展

运行测试

Jest 已配置为测试。要运行测试套件，请执行以下操作：

npm test

代码质量检查

要同时运行类型检查、linting 和测试：

npm run check-codebase

使用 MCP Inspector 运行

对于使用模型上下文协议检查器进行本地开发和测试，您可以启动应用程序并使用-e标志传递所需的环境变量：

npx @modelcontextprotocol/inspector -e JIRA_BASE_URL=https://your-domain.atlassian.net -e JIRA_USERNAME=your-email@example.com -e JIRA_API_TOKEN=your-api-token -e DEBUG=true node build/index.js

（如果使用build/index.js ，请确保已先构建项目）

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。