Rust Jira MCP

MCP办公协作

提供方 GarthDB

办公协作 未标注 Token 社区 / 第三方

一个基于Rust的高性能Jira MCP服务器,提供全面的Jira API集成,包括问题管理、项目配置、批量操作和Zephyr测试管理。

一句话选型结论

按资料字段整理

Rust Jira MCP 属于办公协作类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Jira集成Rust本地部署问题管理项目配置Rust服务器API工具

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Rust Jira MCP当前 未标注 未标注 未标注 无 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方GarthDB上游标注的维护方 GarthDB
分类办公协作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.5 KB
来自项目仓库与上游目录的原文,未做删改

Rust Jira MCP 服务器

一个高性能的基于Rust的模型上下文协议(MCP)服务器,用于全面集成Jira API。该服务器通过MCP兼容的客户端,为问题管理、项目配置、批量操作和Zephyr测试管理提供了广泛的工具支持。

🚀 快速入门```bash

Clone and build

git clone https://github.com/GarthDB/rust-jira-mcp.git
cd rust-jira-mcp
cargo build --release

Configure your credentials

cp env.example .env

Edit .env with your Jira credentials

Run the server

cargo run --release


## 🧪 测试与开发

这个项目包含一个基于xtask的全面测试框架,用于安全开发和测试:

### 测试命令```bash
# Test MCP operations
cargo run --package xtask -- test --suite read-only --project DNA
cargo run --package xtask -- test --suite issues --project DNA
cargo run --package xtask -- test --suite write --safe

# Collect test fixtures from live API
cargo run --package xtask -- collect-fixtures --project DNA

# Generate synthetic test data
cargo run --package xtask -- generate-fixtures --project TEST-MCP

# Run comprehensive test suite
cargo run --package xtask -- test-suite --project TEST-MCP

# Clean up test data
cargo run --package xtask -- cleanup --project TEST-MCP

Makefile 快捷键```bash

Quick test commands

make test-readonly # Run read-only tests
make test-issues # Run issue tests
make test-write # Run write tests (safe project only)
make test-suite # Run comprehensive test suite
make test-cleanup # Clean up test data

Fixture management

make collect-fixtures # Collect real API data
make generate-fixtures # Generate synthetic data


### 安全特性

- **安全测试**使用 `--safe` 标志或 `TEST-MCP` 写操作项目
- **数据匿名化**在测试数据中自动对敏感数据进行匿名化处理
- **清理**操作后自动清理测试数据

## 📖 文档

- **文档索引** - 完整的文档概览与导航
- **入门指南** - 完整的安装与使用指南
- **API 文档** 完整API参考(使用rustdoc生成)
- **配置指南** - 全面的配置管理
- **配置示例** - 详细的配置示例
- **工具示例** - 所有MCP工具的详细示例
- **故障排除指南** - 常见问题及解决方案
- **性能指南** - 优化和基准测试

## 特点/特性

### 核心Jira操作

- **问题管理**创建、阅读、更新、搜索和转移问题
- **评论**在问题上添加和检索评论
- **认证**测试Jira API的连接性和身份验证

### 项目配置和元数据(新增!)

- **项目配置**检索详细的项目配置设置
- **问题类型**获取特定项目可用的工单类型
- **问题类型元数据**获取特定问题类型的详细信息
- **项目组成部分**检索与项目相关的组件
- **优先级与状态**获取所有可用的优先级和状态
- **自定义字段**检索自定义字段定义
- **综合元数据**在一次调用中获取所有项目元数据

## 安装

1. 克隆仓库:```bash
git clone
cd rust-jira-mcp
  1. 构建项目:```bash
    cargo build --release

3. 在配置文件或环境变量中设置您的Jira凭据。

## 配置

该服务器包含一个全面的配置管理系统,支持环境变量、配置文件、密钥管理以及热加载功能。

### 🔐 认证设置

服务器支持 **两种认证方法** 并根据您的令牌格式自动检测应使用哪一个:

#### 方法1:Adobe Jira(使用Bearer Token认证)

对于Adobe Jira实例,请直接使用您的Bearer令牌:```bash
# Required for Adobe Jira
JIRA_EMAIL=your.email@adobe.com
JIRA_PERSONAL_ACCESS_TOKEN=YOUR_ADOBE_JIRA_TOKEN_HERE
JIRA_API_BASE_URL=https://jira.corp.adobe.com/rest/api/2

方法2:标准Jira(基本认证)

对于标准的 Atlassian Jira 实例,请使用基本身份验证:```bash

Required for Standard Jira

JIRA_EMAIL=your.email@company.com
JIRA_PERSONAL_ACCESS_TOKEN=your_standard_pat_token
JIRA_API_BASE_URL=https://your-company.atlassian.net/rest/api/2


### 🧠 智能身份验证检测

服务器会自动检测您的认证方式:

- **Bearer Token(携带者令牌)**如果你的令牌长度较长(>20个字符)且不包含冒号
- **基本认证(Basic Auth)**如果你的令牌较短或包含冒号(例如 `user:password`)

### 快速入门

创建一个 `.env` 在项目根目录中的文件:```bash
# Required - Choose one based on your Jira instance
JIRA_EMAIL=your.email@company.com
JIRA_PERSONAL_ACCESS_TOKEN=your_token_here

# Optional
JIRA_API_BASE_URL=https://your-company.atlassian.net/rest/api/2
JIRA_DEFAULT_PROJECT=PROJ
JIRA_MAX_RESULTS=50
JIRA_TIMEOUT_SECONDS=30

🔍 测试您的身份验证

测试您的身份验证设置:```bash

Test with curl (Adobe Jira - Bearer)

curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://jira.corp.adobe.com/rest/api/2/myself"

Test with curl (Standard Jira - Basic)

curl -u "your.email@company.com:YOUR_TOKEN" \
"https://your-company.atlassian.net/rest/api/2/myself"

Test with the MCP server

cargo run --release

Then call the test_jira_auth tool


### 配置特性

- ✅ **环境变量**通过环境变量支持所有配置
- ✅ **配置文件**支持 TOML、YAML 和 JSON 配置文件
- ✅ **密钥管理**安全处理敏感数据,提供多种存储选项
- ✅ **配置验证**全面验证,附带详细错误信息
- ✅ **热加载**当文件发生变化时自动重新加载配置
- ✅ **多个来源**支持多个配置源并具有优先级排序
- ✅ **默认值**所有配置选项的合理默认值

### 配置源(优先级顺序)

1. 环境变量(最高优先级)
1. .env 文件
1. 自定义配置文件(通过指定 `JIRA_CONFIG_FILE`)
1. config/default.toml(配置/默认.toml)
1. 默认值(最低优先级)

## 可用工具

### 核心工具

- `test_jira_auth` 使用Jira API测试认证
- `search_jira_issues` - 使用JQL搜索问题
- `create_jira_issue` - 创建新问题
- `update_jira_issue` - 更新现有问题
- `get_jira_issue` - 获取问题详情
- `get_jira_comments` - 获取问题评论
- `add_jira_comment` - 在问题上添加评论
- `get_jira_transitions` - 获取可用的转换
- `transition_jira_issue` - 过渡到新状态的问题

### 项目配置和元数据工具

- `get_project_config` - 获取项目配置详情
- `get_project_issue_types` - 获取项目的议题类型
- `get_issue_type_metadata` - 获取详细的议题类型信息
- `get_project_components` - 获取项目组件
- `get_priorities_and_statuses` - 获取所有优先级和状态
- `get_custom_fields` - 获取自定义字段定义
- `get_project_metadata` - 获取全面的项目元数据

### 冲刺管理工具(新推出!)

- `get_sprint` - 通过冲刺ID获取冲刺详情
- `create_sprint` - 创建一个新的冲刺(或迭代)
- `add_issues_to_sprint` - 将问题添加到冲刺中
- `get_sprint_issues` - 获取冲刺(Sprint)中的所有问题
- `start_sprint` - 开始冲刺(将状态设置为活跃)
- `close_sprint` - 结束一个冲刺(将状态设置为已结束)
- `get_board_sprints` - 获取看板的所有冲刺(Sprint)

## 使用示例

### 基本问题操作```json
{
"method": "tools/call",
"params": {
"name": "search_jira_issues",
"arguments": {
"jql": "project = TEST AND status = Open",
"max_results": 10
}
}
}

项目元数据操作```json

{
"method": "tools/call",
"params": {
"name": "get_project_metadata",
"arguments": {
"project_key": "TEST"
}
}
}


### 获取项目的工单类型```json
{
"method": "tools/call",
"params": {
"name": "get_project_issue_types",
"arguments": {
"project_key": "TEST"
}
}
}

获取所有优先级和状态```json

{
"method": "tools/call",
"params": {
"name": "get_priorities_and_statuses",
"arguments": {}
}
}


### 冲刺管理运营```json
{
"method": "tools/call",
"params": {
"name": "get_sprint_issues",
"arguments": {
"sprint_id": 12345,
"max_results": 50
}
}
}

运行服务器

作为一个独立的二进制文件```bash

cargo run --release


### 作为MCP服务器

服务器实现了MCP协议,可以与任何兼容MCP的客户端一起使用。

## 示例

查看 `examples/` 使用示例目录:

- `project_metadata_example.rs` - 展示新的项目配置和元数据工具
- `simple_config_example.rs` - 展示基本的配置管理用法
- `configuration_example.rs` - 全面的配置系统演示

## 测试

运行测试套件:```bash
cargo test

发展

项目结构```

src/
├── config/ # Configuration management
├── error/ # Error handling
├── jira/ # Jira API client
│ ├── client.rs # Main client implementation
│ └── operations/ # Specific operation modules
├── mcp/ # MCP server implementation
│ ├── server.rs # MCP server
│ └── tools.rs # Tool implementations
├── types/ # Type definitions
└── utils/ # Utility functions


### 添加新工具

1. 实现工具结构体 `src/mcp/tools.rs`
1. 将该工具添加到服务器注册中 `src/mcp/server.rs`
1. 将工具定义添加到 `list_tools()` 方法
1. 在(相应位置)添加对应的客户端方法 `src/jira/client.rs` 如需

## 覆盖范围

该项目使用全面的测试工具,保持了高测试覆盖率:

### 覆盖状态

- **总体覆盖率**~75%(不包括测试工具)
- **目标覆盖率**百分之八十
- **应用程序代码**70-75%的覆盖率

### 覆盖工具```bash
# Quick coverage check
make coverage-check

# Detailed analysis
make coverage-analyze

# Get test suggestions for a module
make coverage-suggest MODULE=main

# Open HTML coverage report
make coverage-dashboard

覆盖监测

  • Codecov.io(可译为“科德科夫点IO”,但通常直接保留原名,因其为专有名词)持续覆盖监测
  • GitHub Actions在PR(Pull Request,拉取请求)中自动生成覆盖率报告
  • 覆盖徽章README中的实时覆盖状态

做出贡献

  1. 为仓库创建分支(或“克隆仓库”)
  2. 创建一个特性分支
  3. 进行你的更改
  4. 添加测试(目标覆盖率80%+)
  5. 跑 make coverage-check 验证覆盖范围
  6. 提交一个拉取请求

覆盖范围要求

  • 新功能必须保持或提高整体覆盖率
  • 关键模块(main.rs、jira_client、mcp_tools)的覆盖率应达到80%以上
  • 使用 make coverage-suggest MODULE= 作为指导

许可证

[在此添加您的许可证信息]

更新日志

版本 0.1.0

  • 初始发布,包含核心Jira操作功能
  • 添加了项目配置和元数据工具
  • 全面的MCP服务器实现
  • 全面测试覆盖

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Rust Jira MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Rust Jira MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Rust Jira MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Rust Jira MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Rust Jira MCP 能提供哪些能力?

资料显示能力标签包括 Jira集成、问题管理、Rust、API集成。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。