AI导哈

Jira用户故事交互服务器

一个模型上下文协议（MCP）服务器，使Claude Code能够与Jira交互，获取用户故事及其完整详情。

  • by YahyaQandel
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 YahyaQandel/jira-mcp-server

使用说明

Jira MCP服务器

一个模型上下文协议（MCP）服务器，使Claude Code能够与Jira交互，以获取用户故事及其完整细节。

特性

  • 按ID获取用户故事：检索Jira问题的完整详细信息，包括：

    • 摘要和说明
    • 故事点（自定义字段_10016）
    • 状态和状态类别
    • 受让人和报告人详细信息
    • 所有带有作者信息和时间戳的评论
    • 问题类型

  • 搜索用户故事：使用JQL（Jira查询语言）搜索具有可配置结果限制的问题

安装说明

1.先决条件

  • Node.js（v18或更高版本）
  • 具有API访问权限的Jira帐户
  • 已安装克劳德代码

2.安装

# Clone or navigate to the project directory
cd /Users/yahya/projects/self/mcp-servers/jira-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

3.配置Jira凭据

服务器使用TERACLOUD前缀的环境变量，这些变量应该已经来源于您的shell：

所需的环境变量：

  • COMPANY_JIRA_BASE_URL：您的Atlassian域名（例如。， https://yourcompany.atlassian.net)
  • COMPANY_JIRA_EMAIL：您的Jira电子邮件地址
  • COMPANY_JIRA_API_TOKEN：您的Jira API代币

要生成Jira API令牌，请执行以下操作：

  1. 首选https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击“创建API令牌”
  3. 给它一个标签并复制生成的令牌

由于这些变量已经来源于您的shell，因此不需要对Claude Code进行额外的配置。

4.重新启动克劳德代码

更新配置后，重新启动Claude Code以使更改生效。

Claude代码中的用法

配置后，您可以在Claude Code中使用Jira MCP服务器工具：

获取特定的用户故事：

Use the jira get_user_story tool to fetch issue PROJ-123

搜索用户故事：

Use the jira search_user_stories tool to find all open stories in project PROJ

JQL查询示例：

  • project = PROJ AND issuetype = Story AND status = "In Progress"
  • assignee = currentUser() AND sprint in openSprints()
  • project = PROJ AND created >= -7d
  • labels = bug AND priority = High

可用的MCP工具

get_user_story

通过ID或密钥获取单个Jira问题。

参数：

  • issueIdOrKey （字符串，必填）：问题ID或密钥（例如“PROJ-123”）

退货： 完整的问题详细信息，包括描述、故事点、评论、状态、受让人和报告人。

search_user_stories

使用JQL搜索Jira问题。

参数：

  • jql （字符串，必填）：JQL查询以搜索问题
  • maxResults （number，可选）：返回的最大结果数（默认值：50）

退货： 带有摘要信息的匹配问题列表。

故障排除

服务器未出现在Claude代码中

  1. 确保配置已添加到 ~/.claude.json
  2. 重新启动Claude代码
  3. 检查构建是否成功(npm run build)

身份验证错误

  1. 验证您的API令牌是否正确
  2. 确保您的电子邮件与Jira中使用的电子邮件匹配
  3. 检查您的Jira实例URL是否正确（包括https://）

故事点未显示

故事点通常存储在自定义字段中。此服务器使用 customfield_10016 这很常见，但Jira实例可能使用不同的字段。您可能需要调整源代码中的字段ID。

发展

要修改服务器，请执行以下操作：

  1. 在中编辑源文件 src/
  2. 重建： npm run build
  3. 重新启动Claude Code以加载更新的服务器

对于自动重新加载的开发：

npm run dev

许可证

麻省理工学院

相关 MCP