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 8080SSE端点： 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许可证
麻省理工学院