Skip to main content
Glama

jira-mcp

by CamdenClark

JIRA MCP 服务器

一个 MCP 服务器,支持大型语言模型 (LLM) 通过标准化工具和上下文与 JIRA 交互。此服务器提供使用 JQL 搜索问题以及检索问题详细信息的功能。

特征

  • JQL 搜索:执行复杂的 JQL 查询并支持分页
  • 问题详情:检索有关特定 JIRA 问题的详细信息

先决条件

  • npm安装
  • 具有 API 访问权限的 JIRA 实例
  • JIRA API 令牌或个人访问令牌
  • 与 API 令牌关联的 JIRA 用户电子邮件

获取 JIRA API 凭证

  1. 通过https://id.atlassian.com登录您的 Atlassian 帐户
  2. 导航至安全设置
  3. 在 API 令牌下,选择“创建 API 令牌”
  4. 给你的令牌一个有意义的名字(例如,“MCP 服务器”)
  5. 复制生成的令牌 - 您将无法再次看到它!
  6. 使用此令牌作为您的JIRA_API_KEY
  7. 使用与您的 Atlassian 帐户关联的电子邮件地址作为JIRA_USER_EMAIL

用法

与 Claude Desktop 集成

  1. 将服务器配置添加到 Claude Desktop 的配置文件中:

macOS~/Library/Application Support/Claude/claude_desktop_config.json Windows%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "jira": { "command": "npx", "args": ["-y", "jira-mcp"], "env": { "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net", "JIRA_USER_EMAIL": "your-email@company.com", "JIRA_API_KEY": "your-api-token" } } } }
  1. 重新启动 Claude Desktop 以加载新配置。

可用工具

使用可自定义参数执行 JQL 搜索查询。

参数

  • jql (必需):JQL 查询字符串
  • nextPageToken :分页令牌
  • maxResults :返回的最大结果数
  • fields :要包含的字段名称数组
  • expand :要包含的附加信息

例子

{ "jql": "project = 'MyProject' AND status = 'In Progress'", "maxResults": 10, "fields": ["summary", "status", "assignee"] }

2. 获取问题( get_issue

检索有关特定问题的详细信息。

参数

  • issueIdOrKey (必需):问题 ID 或密钥
  • fields :要包含的字段名称数组
  • expand :要包含的附加信息
  • properties :要包含的属性数组
  • failFast :是否在发生错误时快速失败

例子

{ "issueIdOrKey": "PROJ-123", "fields": ["summary", "description", "status"], "expand": "renderedFields,names" }

发展

配置

在运行服务器之前设置环境变量。在根目录中创建一个.env文件:

JIRA_INSTANCE_URL=https://your-instance.atlassian.net JIRA_USER_EMAIL=your-email@company.com JIRA_API_KEY=your-api-token

将值替换为:

  • 您实际的 JIRA 实例 URL
  • 与您的 JIRA 帐户关联的电子邮件地址
  • 您的 JIRA API 令牌(可以在 Atlassian 帐户设置中生成)

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 JIRA:

npx -y @smithery/cli install jira-mcp --client claude

手动安装

  1. 克隆此存储库:
git clone <repository-url> cd jira-mcp
  1. 安装依赖项:
npm install

使用 MCP Inspector 运行

对于测试和开发,您可以使用 MCP Inspector:

npm run inspect

添加新工具

要添加新工具,请修改index.js中的ListToolsRequestSchema处理程序:

server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ // Existing tools... { name: "your_new_tool", description: "Description of your new tool", inputSchema: { // Define input schema... } } ] }; });

然后在CallToolRequestSchema处理程序中实现该工具。

执照

麻省理工学院

贡献

欢迎贡献!请随时提交 PR。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

提供使用 JQL 搜索Jira问题并检索详细问题信息的功能。

  1. 特征
    1. 先决条件
      1. 获取 JIRA API 凭证
    2. 用法
      1. 与 Claude Desktop 集成
    3. 可用工具
      1. JQL 搜索( jql_search )
      2. 获取问题( get_issue )
    4. 发展
      1. 配置
      2. 安装
      3. 通过 Smithery 安装
      4. 手动安装
      5. 使用 MCP Inspector 运行
      6. 添加新工具
    5. 执照
      1. 贡献

        Related MCP Servers

        • A
          security
          F
          license
          A
          quality
          Provides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.
          Last updated -
          6
          6
          JavaScript
          • Apple
        • -
          security
          F
          license
          -
          quality
          Enables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.
          Last updated -
          2
          TypeScript
        • -
          security
          F
          license
          -
          quality
          A server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.
          Last updated -
          Python
        • A
          security
          A
          license
          A
          quality
          A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
          Last updated -
          11
          20
          JavaScript
          MIT License
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/CamdenClark/jira-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server