Jira MCP Server

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

  • Provides comprehensive interaction with Jira's API, enabling JQL query execution, ticket management (creation, editing, deletion), project listing, status retrieval, user assignment, and attachment handling capabilities.

Jira 通信服务器 MCP 服务器

与 Jira 交谈

这是一个基于 TypeScript 的 MCP 服务器,提供与 Jira 交互的工具。它通过以下方式演示了 MCP 的核心概念:

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

特征

Jira 工具

execute_jql

  • 目的:运行 JQL 查询。
  • 参数jqlnumber_of_results (默认值:1)。

get_only_ticket_name_and_description

  • 目的:获取票证名称和描述。
  • 参数jqlnumber_of_results (默认值:1)。

create_ticket

  • 目的:创建 Jira 票证。
  • 参数project.keysummarydescriptionissuetype.nameparent (可选)。

list_projects

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

delete_ticket

  • 目的:删除一张票。
  • 参数issueIdOrKey

edit_ticket

  • 目的:修改票证。
  • 参数issueIdOrKeysummary (可选)、 description (可选)、 labels (可选)、 parent (可选)。

get_all_statuses

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

assign_ticket

  • 目的:将票分配给用户。
  • 参数accountIdissueIdOrKey

query_assignable

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

add_attachment

  • 目的:向票证添加附件。
  • 参数issueIdOrKeyimageUrl

发展

安装依赖项:

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

调试

由于 MCP 服务器通过 stdio 进行通信,调试起来可能比较困难。我们推荐使用MCP Inspector ,它以包脚本的形式提供:

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

ID: v7nmyscj80