项目介绍
<h1 align="center">
<br>
<a href="https://github.com/lgndluke/REI3-Tickets-MCP-Server"><img width="128" alt="REI3_MCP_Server_Logo" src="https://gips3.baidu.com/it/u=1546654639,2624706258&fm=3081&app=3081&f=PNG?w=256&h=256" /></a>
<br>
REI3 Tickets MCP 服务器
<br>
</h1>
<h4 align="center">适用于 REI3 Tickets 应用程序的简单 FastMCP 服务器。</h4>
<p align="center">
<a href="#关键特性">关键特性</a> •
<a href="#安装">安装</a> •
<a href="#演示">演示</a> •
<a href="#致谢">致谢</a> •
<a href="#捐赠">捐赠</a>
</p>
关键特性
- 创建工单。
- 创建工单工作日志条目。
- 通过工单密钥关闭工单的功能。
- 通过工单密钥获取上下文的功能。
- 通过工单密钥获取工单信息的功能。
安装
安装指南(发布版)
-
在 REI3 中创建一个具有访问 Tickets API 角色权限的指定用户。 <br> 此用户将用于身份验证。
-
在您的 REI3 工单实例中设置一个 API 配置文件。 <br> 您可以在以下位置创建一个:工单 > 管理标签 > API 配置文件
-
下载 最新发布版。
-
设置执行策略为 Bypass -> 如果您计划使用快捷方式 'open_config.ps1' 脚本。
-
调整 config.ini 文件中的变量。
-
启动 'REI3 Tickets MCP 服务器.exe'
安装指南(手动)
-
安装 Python 3.13.5。
-
安装 uv Python 包管理器。
-
将 uv 添加到 PATH。
-
在 REI3 中创建一个具有访问 Tickets API 角色权限的指定用户。 <br> 此用户将用于身份验证。
-
在您的 REI3 工单实例中设置一个 API 配置文件。 <br> 您可以在以下位置创建一个:工单 > 管理标签 > API 配置文件
-
下载/克隆并解压此仓库,并调整 config.ini 文件中的变量。
-
确保您有一个能够运行 MCP 工具的 MCP 客户端。 <br> 我使用了 AnythingLLM
-
配置 MCP-Server JSON 配置以包含 REI3-Tickets-MCP-Server。
安装指南(Docker)
-
安装 docker。
-
安装 git。
-
在 REI3 中创建一个具有访问 Tickets API 角色权限的指定用户。 <br> 此用户将用于身份验证。
-
在您的 REI3 工单实例中设置一个 API 配置文件。 <br> 您可以在以下位置创建一个:工单 > 管理标签 > API 配置文件
-
下载/克隆并解压此仓库,并调整 config.ini 文件中的变量。
-
运行 setup_docker.ps1 脚本,它会为您创建 Docker 镜像,并提供如何创建容器的说明。
MCP-Server JSON 配置示例(适用于 AnythingLLM):
对于传输模式 'stdio':
{
"mcpServers": {
"REI3-Tickets-MCP-Server" : {
"command": "uv",
"args": [
"--directory",
"ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\REI3-Tickets-MCP-Server-main",
"run",
"rei3_tickets_mcp_server.py"
]
}
}
}
对于传输模式 'http':
{
"mcpServers": {
"REI3-Tickets-MCP-Server" : {
"url": "http://127.0.0.1:54321/mcp/",
"type": "streamable"
}
}
}
演示
使用 REI3-Tickets-MCP-Server 创建 REI3 工单:
<img width="1309" height="248" alt="Create_Ticket_with_MCP_Server" src="https://gips0.baidu.com/it/u=2194821679,3283001708&fm=3081&app=3081&f=PNG?w=1309&h=248" />
创建的工单:
<img width="1918" height="947" alt="Created_Ticket_in_Not_Assigned" src="https://gips0.baidu.com/it/u=1464558597,1930418109&fm=3081&app=3081&f=PNG?w=1918&h=947" />
创建的工单工作日志:
<img width="1876" height="806" alt="Created_Ticket_Worklog" src="https://gips1.baidu.com/it/u=1717103436,401211851&fm=3081&app=3081&f=PNG?w=1876&h=806" />
在现有工单内创建工作日志条目:
<img width="1320" height="398" alt="Create_Ticket_Worklog_with_MCP_Server" src="https://gips1.baidu.com/it/u=3919839524,497923511&fm=3081&app=3081&f=PNG?w=1320&h=398" />
创建的工单工作日志:
<img width="1877" height="810" alt="Create_Second_Ticket_Worklog" src="https://gips3.baidu.com/it/u=741519734,679945003&fm=3081&app=3081&f=PNG?w=1877&h=810" />
致谢
本软件利用了:
捐赠
<div align=center>
<a href='https://www.paypal.com/paypalme/lgndluke' target='_blank'><img height='50' src='https://upload.wikimedia.org/wikipedia/commons/thumb/b/b5/PayPal.svg/2560px-PayPal.svg.png' alt='支持我通过PayPal'/></a>
</div>