rei3-tickets-mcp-server

🚀 REI3 Tickets MCP Server

REI3 Tickets MCP Server 是一款为 REI3 Tickets 应用程序打造的简易 FastMCP 服务器，能为相关票务处理工作提供便利，提升操作效率。

✨ 主要特性

• 创建票务。
• 创建票务工作日志条目。

🗺️ 路线图

• 按票务密钥关闭票务功能。
• 按票务密钥获取上下文功能。
• 按票务密钥获取票务信息功能。

📦 安装指南

安装说明（发布版）

1. 安装 Python 3.13.5。
2. 在 REI3 中创建一个具有票务 API 角色访问权限的指定用户。此用户将用于身份验证。
3. 在你的 REI3 票务实例中设置一个 API 配置文件。你可以在以下路径创建：Tickets > 管理选项卡 > API 配置文件。
4. 下载 最新版本。
5. 如果你打算使用快捷方式 open_config.ps1 脚本，请执行 Set-ExecutionPolicy Bypass。
6. 调整 config.ini 文件变量。
7. 启动 REI3 Tickets MCP Server.exe。

安装说明（手动）

1. 安装 Python 3.13.5。
2. 安装 uv Python 包管理器。
3. 将 uv 添加到系统环境变量 PATH 中。
4. 在 REI3 中创建一个具有票务 API 角色访问权限的指定用户。此用户将用于身份验证。
5. 在你的 REI3 票务实例中设置一个 API 配置文件。你可以在以下路径创建：Tickets > 管理选项卡 > API 配置文件。
6. 下载/克隆并解压此仓库，然后调整 config.ini 文件变量。
7. 确保你有一个能够运行 MCP 工具的 MCP 客户端。示例中使用的是 AnythingLLM。
8. 配置 MCP-Server JSON 配置以包含 REI3-Tickets-MCP-Server。

安装说明（Docker）

1. 安装 docker。
2. 安装 git。
3. 在 REI3 中创建一个具有票务 API 角色访问权限的指定用户。此用户将用于身份验证。
4. 在你的 REI3 票务实例中设置一个 API 配置文件。你可以在以下路径创建：Tickets > 管理选项卡 > API 配置文件。
5. 下载/克隆并解压此仓库，然后调整 config.ini 文件变量。
6. 运行 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 票务：

此处可根据实际操作步骤进行补充说明。

创建的票务：

此处可展示创建票务后的相关信息。

创建的票务工作日志：

此处可展示创建票务工作日志后的相关信息。

在现有票务中创建工作日志条目：

此处可根据实际操作步骤进行补充说明。

创建的票务工作日志：

此处可展示创建票务工作日志后的相关信息。

📄 鸣谢

本软件使用了以下项目：

• REI3