JiraMcpServer 服务器
服务器 模型上下文协议(MCP) 将Jira作为MCP客户端的工具,例如Claude Desktop。它允许 Claude 通过自然语言直接在 Jira 中查看、创建和更新问题、项目和用户。
先决条件
- .NET 8.0 SDK
- 拥有 API 访问权限的 Jira (Cloud) 帐户
如何生成 Jira API Token
- 访问 id.atlassian.com/manage-profile/security/api-tokens
- Clique em 创建API令牌
- 给令牌命名( 例如 :
claude-mcp)e拉他们 创建 - 复制生成的令牌 — 不会再显示
凭据设置
服务器需要三个环境变量:
| 变量 | 描述 | 示例 |
|---|---|---|
JIRA_BASE_URL Jira 实例的基本 URL。 https://suaorg.atlassian.net | ||
JIRA_EMAIL | E-mail da conta Jira | voce@exemplo.com |
JIRA_API_TOKEN | 在上一步中生成的 API Token | ATATxxxxxxxxxxxxxxxx |
终端(Linux/macOS)
export JIRA_BASE_URL="https://suaorg.atlassian.net"
export JIRA_EMAIL="voce@exemplo.com"
export JIRA_API_TOKEN="ATATxxxxxxxxxxxxxxxx"终端窗口(cmd)
set JIRA_BASE_URL=https://suaorg.atlassian.net
set JIRA_EMAIL=voce@exemplo.com
set JIRA_API_TOKEN=ATATxxxxxxxxxxxxxxxx终端窗口(PowerShell)
$env:JIRA_BASE_URL = "https://suaorg.atlassian.net"
$env:JIRA_EMAIL = "voce@exemplo.com"
$env:JIRA_API_TOKEN = "ATATxxxxxxxxxxxxxxxx"克劳德桌面(claude_desktop_config.json)
在下面添加条目 mcpServers 在 Claude Desktop 配置文件中。文件位于 :
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"jira": {
"command": "dotnet",
"args": ["run", "--project", "C:\\Projects\\JiraMcpServer"],
"env": {
"JIRA_BASE_URL": "https://suaorg.atlassian.net",
"JIRA_EMAIL": "voce@exemplo.com",
"JIRA_API_TOKEN": "ATATxxxxxxxxxxxxxxxx"
}
}
}
}智利 使用已发布的二进制代替dotnet run替换"command"通过生成的可执行文件路径dotnet publish.
如何运行
dotnet build # Compilar o projeto
dotnet run # Iniciar o servidor MCP via stdio可用工具
服务器将 12 个 MCP 工具分为三组:
问题
| 工具 | 描述 |
|---|---|
GetIssue 通过键返回问题的详细信息(例如: PROJ-123) | |
CreateIssue 在项目中创建一个新问题 | |
UpdateIssue | 更新现有问题的字段 |
SearchIssues | Busca发布usando JQL(Jira查询语言) |
GetIssueTransitions | 列出一个问题可用的工作流过渡 |
TransitionIssue | 通过过渡 ID 将问题移动到新状态 |
AddComment 添加一个评论到一个问题 | |
GetComments | 返回一个问题的所有评论 |
项目
| 工具 | 描述 |
|---|---|
ListProjects 列出所有可供用户访问的 Jira 项目 | |
GetProject 按键返回项目的详细信息。 |
用户
| 工具 | 描述 |
|---|---|
GetCurrentUser | 返回已验证用户的配置文件 |
SearchUsers 按姓名或电子邮件搜索 Jira 用户 |
