Jira 9.12.14 MCP服务器
这是Jira 9.12.14 API的模型上下文协议（MCP）服务器实现。它允许像Claude这样的AI模型通过定义良好的工具安全地与Jira交互。
特性
- JQL搜索：执行JQL查询以查找Jira中的问题
- 获取问题：按ID或密钥检索特定问题的详细信息
先决条件
- Node.js（v16或更高版本）
- npm或纱线
- Jira实例
- Jira API的身份验证凭据
安装
选项1：使用npx（推荐）
使用此MCP服务器的最简单方法是使用npx：
# Create a directory for your configuration
mkdir jira-mcp && cd jira-mcp
# Create .env file with your credentials
cat > .env 安全>创建和管理API令牌
1. 点击“创建API令牌”
1. 给它起个名字，比如“MCP服务器”
1. 将生成的令牌复制到您的 `.env` 文件或MCP JSON配置
## 用法
### 运行服务器
npm start
### 与Claude for Desktop集成
1. 打开您的Claude进行桌面应用程序配置，网址为 `~/Library/Application Support/Claude/claude_desktop_config.json` （MacOS）或 `%AppData%\Claude\claude_desktop_config.json` （Windows）
1. 添加服务器配置：
{ "mcpServers": { "jira": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/jira-9.12.14-mcp-server/dist/index.js" ], "env": { "MCP_JIRA_API_URL": "https://your-domain.atlassian.net", "MCP_JIRA_AUTH_TOKEN": "your-jira-token" } } } }
替换 `/ABSOLUTE/PATH/TO/` 使用系统上服务器的实际路径。
#### 使用npx
如果你通过npx安装，你的Claude配置如下：
{ "mcpServers": { "jira": { "command": "npx", "args": [ "--yes", "@andrewyun/jira-9-12-14-mcp-server" ], "env": { "MCP_JIRA_API_URL": "https://your-domain.atlassian.net", "MCP_JIRA_AUTH_TOKEN": "your-jira-token" } } } }
**重要**：如果您使用的是MCP JSON环境变量，则不需要 `.env` 文件。如果您没有使用MCP JSON环境变量，请确保您有 `.env` 使用npx时，将文件保存在主目录或安装Claude for Desktop的目录中。
## 可用工具
### JQL搜索(`mcp_jira_jql_search`)
执行JQL查询以查找Jira中的问题。
**参数：**
- `jql` （必填）：JQL查询字符串
- `fields` （可选）：每期要返回的字段列表
- `maxResults` （可选）：返回的最大结果数
- `startAt` （可选）：要返回的第一个结果的索引
- `expand` （可选）：回复中应包含的其他信息
### 获取问题(`mcp_jira_get_issue`)
按ID或密钥检索有关特定问题的详细信息。
**参数：**
- `issueIdOrKey` （必填）：问题的ID或密钥
- `fields` （可选）：要包含在响应中的字段列表
- `expand` （可选）：回复中应包含的其他信息
- `properties` （可选）：要包含在响应中的属性
- `failFast` （可选）：是否在错误时快速失败（默认值：false）
## 故障排除
如果您看到以下错误 `JIRA_API_URL environment variable is required`，确保您：
1. 创建了一个 `.env` 运行服务器的目录中的文件，或者
1. 已提供 `MCP_JIRA_API_URL` 和 `MCP_JIRA_AUTH_TOKEN` 在您的Claude for Desktop配置中
麻省理工学院