AI导哈

OTOBO票务搜索服务器

一个基于MCP协议的服务器，用于通过OTOBO的通用接口REST API搜索和检索票务信息。

  • by siscale
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 siscale/otobo-mcp-server

使用说明

OTOBO MCP服务器

一 主控程序 用于搜索和检索门票的服务器 奥托博 通过通用接口REST API。

先决条件

  • Python 3.10+
  • 启用了通用接口的OTOBO实例
  • 紫外线 包管理器

OTOBO web服务设置

在 管理>Web服务，使用以下操作创建或编辑web服务：

操作 路线 方法
票务：：票务搜索 /TicketSearch POST
票：小票 /小票 邮寄

两者都需要POST——GET无法处理嵌套的搜索参数。

快速入门

git clone https://github.com/youruser/otobo-mcp-server.git
cd otobo-mcp-server

# Create environment and install dependencies
uv venv
source .venv/bin/activate
uv sync

运行服务器：

# STDIO (default)
uv run otobo_mcp_server.py

# SSE
uv run otobo_mcp_server.py -t sse -p 8080

# Streamable HTTP
uv run otobo_mcp_server.py -t streamable-http -p 8080

配置

所有配置都是通过环境变量进行的：

变量 必填 默认 描述
OTOBO_HOST 是 基本URL，例如。 https://otobo.example.com
OTOBO_USER 是 代理用户名
OTOBO_PASSWORD 是 代理密码
OTOBO_WEBSERVICE 没有 GenericTicketConnectorREST OTOBO管理中的Web服务名称
OTOBO_SSL_VERIFY 没有 true SSL证书验证
OTOBO_TIMEOUT 没有 30 HTTP超时（秒）
OTOBO_TRANSPORT 没有 stdio 传输方式：stdio、sse、可流式传输http

对于SSE/HTTP传输，绑定地址通过以下方式设置 FASTMCP_HOST （默认值 127.0.0.1)以及 FASTMCP_PORT （默认值 8000)，或使用 --host / --port 旗帜。

用法

    "otobo": {
      "command": "uv",
      "args": [
        "--directory", "/absolute/path/to/otobo-mcp-server",
        "run", "otobo_mcp_server.py"
      ],
      "env": {
        "OTOBO_HOST": "https://otobo.example.com",
        "OTOBO_USER": "api_agent",
        "OTOBO_PASSWORD": "secret"
      }
    }

使用Claude代码

claude mcp add otobo \
  -e OTOBO_HOST=https://otobo.example.com \
  -e OTOBO_USER=api_agent \
  -e OTOBO_PASSWORD=secret \
  -- uv --directory /absolute/path/to/otobo-mcp-server run otobo_mcp_server.py

远程（SSE/流式HTTP）

uv run otobo_mcp_server.py -t sse --host 0.0.0.0 -p 8080

SSE端点： http://your-host:8080/sse 可流式传输的HTTP端点： http://your-host:8080/mcp

工具

搜索门票 --使用过滤器搜索：标题关键字、日期范围、状态、优先级、客户、队列。返回包含票证详细信息和所有文章/评论的JSON。

获取门票详情 --通过带有动态字段和文章的ID获取单张票。

获取门票_文章 --仅获取工单的文章/评论历史记录。

check_connection --验证OTOBO连接和身份验证。

测试

# With MCP Inspector
npx @modelcontextprotocol/inspector uv run otobo_mcp_server.py

许可证

麻省理工学院

相关 MCP