Skip to main content
Glama

JIRA MCP 服务器

铁匠徽章

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

特征

  • JQL 搜索:执行复杂的 JQL 查询并支持分页

  • 问题详情:检索有关特定 JIRA 问题的详细信息

Related MCP server: Python Jira MCP Server

先决条件

  • 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 以加载新配置。

可用工具

1. JQL 搜索( jql_search

使用可自定义参数执行 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。

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

Latest Blog Posts

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