Jira多通道平台服务器

Jira MCP服务器

这是一个用于与Jira集成的多通道平台（MCP）服务器。它将Jira操作（搜索、获取、创建、更新、转换、注释等）作为MCP工具公开，使Jira易于自动化并与其他系统连接。

先决条件

• Python 3.8+
• Jira云账户（带API代币）
• fastMCP （通过requirements.txt安装）
• （可选） OpenWeb用户界面 用于UI集成

安装说明

1. 克隆存储库

   复制

   git clone <your-repo-url>
   cd jira_mcp
   

2. 安装依赖项

   复制

   pip install -r requirements.txt
   

3. 配置Jira凭据 创建一个 .env 项目根目录中的文件（或设置环境变量）：

   复制

   JIRA_BASE_URL=https://your-domain.atlassian.net
   JIRA_USER=your-email@example.com
   JIRA_API_TOKEN=your-api-token
   

   或者，您可以使用 config.yaml 对于fastMCP：

   复制

   JIRA_BASE_URL: "https://your-domain.atlassian.net"
   JIRA_USER: "your-email@example.com"
   JIRA_API_TOKEN: "your-api-token"
   

4. 运行MCP服务器

   复制

   python service.py
   

   或者，如果使用fastMCP CLI：

   复制

   fastmcp run service.py --config config.yaml
   

5. 测试服务器

   • 使用MCP CLI或HTTP API调用工具，如 get_issue, search_issues等等。
   • 示例（CLI）：
     复制

     fastmcp actions call get_issue --issue_key EC-123
     

运行和检查MCP服务器

运行MCP服务器

您可以使用以下命令运行MCP服务器：

uvx mcpo --port 8080 -- uv run service.py

• 这将使用以下命令启动端口8080上的MCP服务器 mcpo 工具（fastMCP生态系统的一部分）。
• 您的Jira工具将通过HTTP和/或配置的其他传输提供。
• 在运行此命令之前，请确保已设置环境变量或配置文件。

检查MCP工具（开发）

要交互式检查和测试MCP工具，请使用MCP检查器：

mcp dev service.py

• 这将为您的插件启动MCP检查器。
• 您可以交互式地测试、调试和查看工具的模式（如 get_issue, search_issues等等）。
• 代码更改后重新启动检查器以查看更新。

与OpenWebUI集成

服务器运行并测试后，您可以将OpenWebUI的MCP工具配置指向 http://localhost:8080 （或您选择的端口）从UI启用Jira自动化和工作流。

请随时分叉、贡献或公开问题以进行改进！