Version: 5.1.0

TIS MCP Tools 总览

从 TIS 5.1 版本开始，TIS 内置了标准的 MCP（Model Context Protocol）Server。它将 TIS 数据集成平台的核心能力——数据源、数据管道、执行历史、任务日志、增量同步状态等——以 MCP Tool 的形式暴露出来，使开发者可以在 Hermes 等 AI Agent 工具中直接查询和操作 TIS，无需切换到 TIS Web 控制台。

TIS MCP 的价值

TIS MCP 的定位是 AI 的「传感器」：让开发者在 AI Agent 中拥有数据集成平台的全局视角——数据从哪来、怎么流、现在什么状态、出了什么问题。

典型使用场景：

场景	在 Agent 中的提问	用到的 Tool
盘点数据资产	"TIS 里配置了哪些数据源？有哪些数据管道？"	`list_datasources`、`list_pipeline`
排查数据问题	"线上订单数据不对，mysql2doris_orders 管道是不是挂了？"	`get_pipeline_status`、`get_task_log`
新增字段确认	"上游 MySQL 的 order 表有 discount_rate 这个字段吗？"	`list_tables`、`get_table_columns`
上线前检查	"所有管道最近的执行成功率怎么样？"	`get_pipeline_exec_history`
触发同步	"帮我跑一下 mysql2doris_orders 的全量同步"	`trigger_pipeline_batch_synchronize`
自然语言问数	"最近一个月销售额最高的前 10 个产品是什么？"	`chat_bi`

服务接入信息

TIS MCP Server 随 TIS 控制台自动启动，无需单独安装或启动进程。TIS 控制台启动时（ConsoleInitilizeListener）会自动注册 MCP Servlet。

项目	值
服务地址	`http://{tis_host}:8080/tjs/mcp`
传输协议	MCP Streamable HTTP（JSON-RPC 2.0 over HTTP POST）
协议版本	`2025-03-26`（兼容 `2024-11-05`）
会话机制	首次 `initialize` 请求后在响应头 `Mcp-Session-Id` 中返回会话 ID，后续请求需携带
Server 标识	`tis-mcp-server` / `1.0.0`

安全提示

当前版本的 MCP 端点未启用访问鉴权。请将 TIS 部署在内网环境使用，或在网关 / 反向代理层增加访问控制，避免将 /tjs/mcp 端点暴露到公网。

Tool 清单

TIS 5.1 共提供 12 个 MCP Tool，遵循「读多写少、查询优先」的设计原则，按用途分为四个层次：

第一层：数据资产感知（5 个）

跨数据源的全局视角，这是 TIS MCP 区别于单一数据库 MCP Server 的核心能力。

Tool	功能	文档
`list_datasources`	列出 TIS 中已配置的所有数据源	文档
`list_pipeline`	列出所有端到端数据同步管道	文档
`get_pipeline_detail`	获取指定管道的详细配置	文档
`list_tables`	列出指定数据源下的所有表	文档
`get_table_columns`	获取指定表的列元数据	文档

第二层：运维诊断（4 个）

在 Agent 中直接排查数据同步问题，无需切换到 TIS 控制台。

Tool	功能	文档
`get_pipeline_status`	获取管道最近一次批量同步结果与增量同步运行状态	文档
`get_pipeline_exec_history`	获取管道最近 N 次批量同步执行记录	文档
`get_task_log`	获取指定任务的执行日志（支持级别过滤）	文档
`get_incr_sync_status`	获取管道增量（实时）同步的详细运行状态	文档

第三层：轻量操作（2 个）

参数极简的确定性操作。建议依赖 Agent 客户端的 Tool 调用确认机制，由用户确认后再执行。

Tool	功能	文档
`trigger_pipeline_batch_synchronize`	触发指定管道执行一次批量全量同步	文档
`toggle_incr_sync`	启动或停止指定管道的增量（实时）同步	文档

智能问数（1 个）

Tool	功能	文档
`chat_bi`	基于本体（Ontology）的自然语言问数，自动生成并执行 SQL	文档

后续规划

数据血缘追溯（get_data_lineage）以及管道创建类 Tool 在当前版本暂未开放。创建类操作建议通过 TIS Web 控制台完成，待 MCP 协议的 Sampling / Elicitation 能力在各客户端普及后会重新评估开放。

在 Hermes 中配置并启用

下面以 Hermes 为例说明接入步骤，其他兼容 MCP Streamable HTTP 的 Agent 客户端配置方式类似。

步骤 1：确认 TIS MCP 服务可用

确认 TIS 控制台已启动（5.1 及以上版本），MCP 端点随控制台自动就绪，地址为：

http://{tis_host}:8080/tjs/mcp

可以使用 curl 快速验证服务是否正常（发送 initialize 请求）：

curl -v -X POST http://{tis_host}:8080/tjs/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "curl-test", "version": "1.0.0" }
    }
  }'

服务正常时，响应头中会返回 Mcp-Session-Id，响应体为 Server 能力描述（serverInfo: tis-mcp-server）。

步骤 2：在 Hermes 中添加 MCP Server

打开 Hermes 的 MCP 服务器管理（设置 → MCP Servers / 工具集成）
新增一个 MCP Server，配置如下：
- 名称：tis（可自定义）
- 传输类型：Streamable HTTP（或 HTTP，视 Hermes 版本的叫法）
- URL：http://{tis_host}:8080/tjs/mcp
保存并启用该服务器

上图：在 Hermes 中添加 TIS MCP Server——名称为 tis，传输类型选择 Streamable HTTP，URL 填写 http://{tis_host}:8080/tjs/mcp。

步骤 3：确认 Tool 已加载

启用后，在 Hermes 的工具列表中应能看到 TIS 提供的 12 个 Tool（list_datasources、list_pipeline、get_pipeline_status、chat_bi 等）。若列表为空，请检查 TIS 控制台日志与网络连通性。

上图：TIS MCP Server 连接成功后，Hermes 中展示的 12 个可用 Tool 列表。

步骤 4：在对话中使用

直接在 Hermes 对话框中用自然语言提问即可，例如：

TIS 里配置了哪些数据源？

mysql2doris_orders 管道最近一次同步成功了吗？失败的话把错误日志给我看

为提高 Tool 命中率，也可以显式指定 Tool 名称：

使用 list_pipeline 工具：列出 TIS 中的所有数据管道

使用 chat_bi 工具：最近一个月销售额最高的前 10 个产品是什么？

上图：在 Hermes 中通过 MCP 调用 TIS 的 chat_bi 工具进行自然语言问数。

通用返回约定

两种返回结构

TIS MCP Tool 的结构化返回（structuredContent）有两种形态，阅读各 Tool 文档时请注意区分：

业务 JSON 直返（大多数查询 / 操作类 Tool）：返回内容即业务结果本身，例如 list_datasources 直接返回 {"datasources": [...]}。
TIS 标准信封（chat_bi、toggle_incr_sync）：返回统一信封结构：

{
  "success": true,
  "errormsg": [],
  "msg": ["操作结果描述"],
  "bizresult": { }
}

信封字段	类型	说明
`success`	boolean	操作是否成功
`errormsg`	string[]	错误信息列表。如出现非空 `errormsg`，调用端应立即终止后续执行并将错误告知用户
`msg`	string[]	成功消息列表
`bizresult`	object	业务结果，结构因 Tool 而异
`errorfields`	array	表单字段级校验错误（仅创建 / 校验类操作可能出现）

错误处理约定

参数缺失或非法：MCP 层返回 isError: true，内容为错误描述文本
服务端内部异常：MCP 层返回 isError: true，内容为通用错误提示（Internal server error...），此时无需分析错误详情，直接告知用户稍后重试即可
chat_bi 的业务失败（如 SQL 生成失败）：通过信封中的 success: false、errormsg 与 bizresult.error 表达，MCP 层的 isError 不一定为 true

注意事项

版本要求：MCP Tools 自 TIS 5.1 版本开始提供，请确认部署的 TIS 版本。
鉴权：当前版本 MCP 端点无内置鉴权，请勿暴露到公网（见上文安全提示）。
操作类 Tool 的确认机制：trigger_pipeline_batch_synchronize、toggle_incr_sync 会真实触发数据同步操作，建议在 Hermes 中开启 Tool 调用确认弹窗，由用户二次确认后执行。
会话保持：MCP Streamable HTTP 基于 Mcp-Session-Id 维持会话，Hermes 等标准客户端会自动处理，无需人工干预。
超时：chat_bi 涉及大模型调用，单次查询可能耗时数秒到数十秒，属正常现象；执行过程中会通过 progressNotification 实时推送进度（详见 chat_bi 文档）。

TIS MCP Tools 总览

TIS MCP 的价值​

服务接入信息​

Tool 清单​

第一层：数据资产感知（5 个）​

第二层：运维诊断（4 个）​

第三层：轻量操作（2 个）​

智能问数（1 个）​

在 Hermes 中配置并启用​

步骤 1：确认 TIS MCP 服务可用​

步骤 2：在 Hermes 中添加 MCP Server​

步骤 3：确认 Tool 已加载​

步骤 4：在对话中使用​

通用返回约定​

两种返回结构​

错误处理约定​

注意事项​