MCP 服务器

Jira MCP Server

一个基于 TypeScript 的服务器，可以通过自然语言与 Jira 进行交互，提供执行 JQL 查询、管理工单、列出项目和状态等工具。

Tools

execute_jql

Execute a JQL query on Jira on the api /rest/api/3/search

get_only_ticket_name_and_description

Get the name and description of the requested tickets on the api /rest/api/3/search

create_ticket

Create a ticket on Jira on the api /rest/api/3/issue

list_projects

List all the projects on Jira on the api /rest/api/3/project

delete_ticket

Delete a ticket on Jira on the api /rest/api/3/issue/{issueIdOrKey}

edit_ticket

Edit a ticket on Jira on the api /rest/api/3/issue/{issueIdOrKey}

get_all_statuses

Get all the status on Jira on the api /rest/api/3/status

assign_ticket

Assign a ticket on Jira on the api /rest/api/3/issue/{issueIdOrKey}/assignee

query_assignable

Query assignables to a ticket on Jira on the api /rest/api/3/user/assignable/search?project={project-name}

add_attachment_from_public_url

Add an attachment from a public url to a ticket on Jira on the api /rest/api/3/issue/{issueIdOrKey}/attachments

add_attachment_from_confluence

Add an attachment to a ticket on Jira from a Confluence page by its name on the api /rest/api/3/issue/{issueIdOrKey}/attachments

README

Jira 通信服务器 MCP 服务器

与 Jira 交互

这是一个基于 TypeScript 的 MCP 服务器，提供与 Jira 交互的工具。它通过提供以下功能来演示核心 MCP 概念：

用于执行 JQL 查询的工具
用于创建、编辑和删除 Jira 事务的工具
用于列出 Jira 项目和状态的工具

功能

Jira 工具

`execute_jql`

目的: 运行 JQL 查询。
参数: jql, number_of_results (默认: 1)。

`get_only_ticket_name_and_description`

目的: 获取事务名称和描述。
参数: jql, number_of_results (默认: 1)。

`create_ticket`

目的: 创建一个 Jira 事务。
参数: project.key, summary, description, issuetype.name, parent (可选)。

`list_projects`

目的: 列出 Jira 项目。
参数: number_of_results (默认: 1)。

`delete_ticket`

目的: 删除一个事务。
参数: issueIdOrKey。

`edit_ticket`

目的: 修改一个事务。
参数: issueIdOrKey, summary (可选), description (可选), labels (可选), parent (可选)。

`get_all_statuses`

目的: 检索所有状态。
参数: number_of_results (默认: 1)。

`assign_ticket`

目的: 将事务分配给用户。
参数: accountId, issueIdOrKey。

`query_assignable`

目的: 在项目中查找可分配的用户。
参数: project_key。

`add_attachment`

目的: 向事务添加附件。
参数: issueIdOrKey, imageUrl。

开发

安装依赖:

npm install

构建服务器:

npm run build

用于自动重建的开发:

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Jira communication server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_API_MAIL": "Your email",
        "JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
      }
    }
  }
}