Jira MCP Toolset

by tbreeding
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables configuration through environment variables stored in .env files for local development, supporting settings like DEBUG and LOG_FILE_PATH.

  • Supports testing the MCP server codebase through Jest's testing framework, accessible via npm test command.

  • Provides tools for interacting with Jira, including fetching and analyzing issues, running JQL queries, and a step-by-step wizard for creating new issues with support for project selection, issue type configuration, and field management.

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

用法

...

配置

环境变量

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

可用工具

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

核心 Jira 工具

  • getJiraIssue :通过密钥获取 Jira 问题。
  • analyzeJiraIssue :对 Jira 问题进行全面分析。
  • jiraGet :从任何 Jira API GET 端点获取数据。
  • getIssuesByJql :使用 JQL 查询搜索 Jira 问题。

问题创建向导工具

这些工具提供了逐步指导的流程,用于创建新的 Jira 问题。向导会在整个创建流程中维护状态,通常涉及以下阶段:启动流程、选择项目 ( getProjects )、选择问题类型 ( getIssueTypes )、检索并填充必要字段( getFieldsupdateFields )、选择性地分析问题详情,以及最终确认并创建问题 ( createIssue )。使用getStategetStatus监控进度,使用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 :分析向导上下文中的问题详细信息。

发展

运行测试

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文件。

-
security - not tested
A
license - permissive license
-
quality - not tested

通过模型上下文协议与 Jira 交互的工具集合,提供获取和分析问题等核心功能,以及指导问题创建向导。

  1. Installation
    1. Usage
      1. Configuration
        1. Environment Variables
      2. Available Tools
        1. Core Jira Tools
        2. Issue Creation Wizard Tools
      3. Development
        1. Running Tests
        2. Code Quality Checks
        3. Running with MCP Inspector
      4. License
        ID: 12ig3l9pdf