AI导哈

Jira问题管理工具

一个基于MCP协议的Jira问题管理工具，支持创建、更新和搜索问题，适用于Jira Cloud和Data Center。

  • by dmaharana
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dmaharana/go-mcp-jira-server

使用说明

实施说明

MCP服务器设置

服务器使用 metoro-io/mcp-golang 具有HTTP传输层（端口8080）的包，以符合对基于HTTPRESTneneneba API的要求。 资源端点(info://server)已注册以提供有关服务器的元数据，包括其名称、版本和可用操作(create_issue, update_issue, search_issues).这允许MCP客户端发现服务器的功能。

Jira客户端

这 JiraClient struct封装Jira API交互，并确定实例是否为Jira Cloud（基于 .atlassian.net 在URL中）或数据中心。 身份验证的处理方式不同：

  • Jira云：使用用户电子邮件和API密钥的基本Auth。
  • 数据中心：使用带有API密钥的承载令牌（个人访问令牌）。 这 getBaseAPIPath 方法选择适当的API路径(/rest/api/3 对于云， /rest/api/2 数据中心）来处理端点差异。

支持的操作

  • 创建问题：

    • 接受 jira_config, project_key, summary, description，以及 issue_type.
    • 向Jira API的问题端点发送POST请求。
    • 返回创建的问题密钥（例如。， PROJ-123).

  • 更新问题：

    • 接受 jira_config, issue_key, summary，以及 description.
    • 发送PUT请求以更新指定的问题。
    • 返回更新的问题密钥。

  • 搜索问题：

    • 接受 jira_config 和 jql 查询（例如。， project = PROJ AND status = Open).
    • 使用JQL查询向搜索端点发送GET请求。
    • 返回问题列表及其关键字和摘要。

MCP工具

每个操作都注册为MCP工具，并带有JSON模式注释，以根据MCP规范定义必填和可选字段。 工具使用以下命令以MCP格式返回响应 mcp_golang.NewToolResponse.

安全和配置

这 JiraConfig 结构包含Jira URL、API密钥和电子邮件（用于云身份验证）。 对于这个例子，配置是在工具处理程序中硬编码的。在生产环境中，为了安全起见，您应该从环境变量或配置文件加载这些变量。

错误处理

该代码包括对HTTP请求、JSON封送处理/取消封送处理和API响应的全面错误处理。 不成功的HTTP状态代码会导致描述性错误消息。

如何跑步

再进行

bash

go get github.com/metoro-io/mcp-golang

运行服务器： bash

go run main.go
服务器将于启动 http://localhost:8080.

使用MCP客户端进行测试

配置您的MCP客户端以发送请求 jira_config 字段，如示例有效载荷所示。 验证服务器是否正确处理每个请求的Jira URL、电子邮件和API密钥。

其他注意事项

安全

  • 在每个请求中传输API密钥需要安全通信（例如HTTPS）。确保服务器配置为在生产环境中使用TLS。
  • 考虑验证提供的Jira URL（例如，检查有效域）以防止误用。

错误处理

中现有的错误处理 JiraClient 将捕获无效URL或凭据等问题。您可能希望为添加特定的验证 JiraConfig 字段（例如，确保URL格式正确或电子邮件对云实例有效）。

演出

创建新 JiraClient 因为每个请求都很简单，但可能会引入开销。如果性能成为问题，请考虑缓存常用配置的客户端（例如，使用由URL和电子邮件键入的映射）。

Jira数据中心

对于数据中心，可能不需要电子邮件字段，因为身份验证通常仅使用API令牌。您可以在 JiraConfig struct并跳过数据中心实例的Basic Auth，但由于 JiraClient 适当地处理身份验证。

测试

要测试更新的服务器，请执行以下操作：

Use a tool like curl or an MCP client to send requests with the `jira_config` fields.
Verify that the server correctly processes different Jira URLs (Cloud and Data Center) and authentication credentials.
Check that the actions (create_issue, update_issue, search_issues) return the expected results.

例如，为了测试 create_issue 使用curl（假设MCP服务器支持原始HTTP POST进行测试）：

bash

    -H "Content-Type: application/json" \
    -d '{
    "jira_config": {
        "url": "https://your-jira-instance.atlassian.net",
        "api_key": "your-api-key",
        "email": "your.email@example.com"
    },
    "project_key": "PROJ",
    "summary": "Test Issue",
    "description": "This is a test",
    "issue_type": "Task"
}'```

### Client examples

### Example Client Requests

Below are example JSON payloads for each action:

**Create Issue**

```json
{
  "function": "create_issue",
  "parameters": {
    "jira_config": {
      "url": "https://your-jira-instance.atlassian.net",
      "api_key": "your-api-key",
      "email": "your.email@example.com"
    },
    "project_key": "PROJ",
    "summary": "Test Issue",
    "description": "This is a test issue created via MCP",
    "issue_type": "Task"
  }
}

更新问题

{
  "function": "update_issue",
  "parameters": {
    "jira_config": {
      "url": "https://your-jira-instance.atlassian.net",
      "api_key": "your-api-key",
      "email": "your.email@example.com"
    },
    "issue_key": "PROJ-123",
    "summary": "Updated Test Issue",
    "description": "Updated description"
  }
}

搜索问题

{
  "function": "search_issues",
  "parameters": {
    "jira_config": {
      "url": "https://your-jira-instance.atlassian.net",
      "api_key": "your-api-key",
      "email": "your.email@example.com"
    },
    "jql": "project = PROJ AND status = Open"
  }
}

相关 MCP