JIRA MCP服务器
一个MCP服务器，使大型语言模型（LLM）能够通过标准化的工具和上下文与JIRA进行交互。此服务器提供使用JQL搜索问题和检索详细问题信息的功能。
特性
- JQL搜索：使用分页支持执行复杂的JQL查询
- 问题详细信息：检索有关特定JIRA问题的详细信息
先决条件
npm安装- 具有API访问权限的JIRA实例
- JIRA API令牌或个人访问令牌
- 与API令牌关联的JIRA用户电子邮件
正在获取JIRA API凭据
- 登录您的Atlassian帐户https://id.atlassian.com
- 导航到安全设置
- 在API令牌下，选择“创建API令牌”
- 为您的令牌命名（例如“MCP服务器”）
- 复制生成的令牌-您将无法再次看到它！
- 使用此令牌作为您的
JIRA_API_KEY - 将与您的Atlassian帐户关联的电子邮件地址用作
JIRA_USER_EMAIL
用法
与Claude Desktop集成
- 将服务器配置添加到Claude Desktop的配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %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"
}
}
}
}- 重新启动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安装
通过以下方式自动安装Claude Desktop的JIRA 史密瑟里:
npx -y @smithery/cli install jira-mcp --client claude手动安装
- 克隆此存储库：
git clone
cd jira-mcp- 安装依赖项：
npm install使用MCP检查器运行
对于测试和开发，您可以使用MCP检查器：
npm run inspect添加新工具
要添加新工具，请修改 ListToolsRequestSchema 处理程序在 index.js:
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
// Existing tools...
{
name: "your_new_tool",
description: "Description of your new tool",
inputSchema: {
// Define input schema...
}
}
]
};
});然后在 CallToolRequestSchema 处理程序。
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交PR。