Apache Doris MCP Server与Dify集成实战指南

概述

本文将详细介绍如何将Apache Doris MCP Server与Dify平台进行深度集成，实现通过自然语言交互执行Doris SQL查询的能力。这种集成方式为数据分析师和业务人员提供了更加友好的数据查询体验。

技术背景

Apache Doris MCP Server是一个中间件服务，它提供了标准化的接口来执行Doris数据库操作。Dify是一个AI应用开发平台，通过集成MCP Server，用户可以直接用自然语言查询Doris数据库，无需编写复杂的SQL语句。

环境准备

安装Doris MCP Server

首先需要安装MCP Server组件：

pip install mcp-doris-server

启动MCP Server服务

启动服务时需要配置Doris数据库连接信息：

doris-mcp-server \
    --transport http \
    --host 0.0.0.0 \
    --port 3000 \
    --db-host 127.0.0.1 \
    --db-port 9030 \
    --db-user root \
    --db-password your_password

启动成功后，服务会监听3000端口，等待接收请求。

网络配置（可选）

如果Dify服务与MCP Server不在同一网络环境，可以考虑使用ngrok等工具建立隧道，将本地服务暴露到公网。

Dify平台配置

插件安装

1. 在Dify控制台中进入"插件市场"
2. 搜索并安装"MCP-SSE/StreamableHTTP"插件

插件配置

安装完成后需要进行服务地址配置：

{
  "doris_mcp_server": {
    "transport": "streamable_http",
    "url": "http://your-server-address/mcp"
}

配置成功后，界面会显示"已授权"状态。

创建Dify应用

1. 点击"新建应用" → "空白应用"
2. 选择"Agent"模板
3. 设置应用名称（如"Doris智能查询助手"）

指令与工具配置

指令模板

在指令区域配置以下模板：

<instruction>
尽可能使用MCP工具完成任务。请仔细阅读每个工具的注释、方法名和参数描述。遵循以下步骤：
1. 分析用户问题并匹配最合适的工具
2. 严格按照定义使用工具名称和参数
3. 以要求的JSON格式传递参数
4. 调用工具时使用格式：
   {"mcp_sse_call_tool": {"tool_name": "<tool_name>", "arguments": "{}"}}
5. 只输出纯文本，不要包含XML标签
<input>
用户问题: user_query
</input>
<output>
返回工具结果或最终答案，包括分析过程
</output>
</instruction>

工具添加

在"工具"面板中添加两个名为"mcp_sse"的工具实例，它们会自动继承插件的传输配置。

实际应用示例

数据库表查询

• 用户输入：数据库中有哪些表？
• 系统行为：自动调用MCP工具执行SHOW TABLES命令
• 输出结果：以清晰格式展示数据库中的所有表

销售趋势分析

• 用户输入：过去十年ssb数据库中的销售趋势如何？哪一年增长最快？
• 系统行为：
  1. 自动生成合适的SQL查询
  2. 计算各年份增长率
  3. 识别增长最快的年份
• 输出结果：包含数据表格和趋势分析的文字说明

最佳实践建议

1. 权限控制：确保MCP Server使用的数据库账号具有适当的权限限制
2. 性能优化：对于复杂查询，建议在Doris中预先创建物化视图
3. 错误处理：在指令模板中加入错误处理逻辑，提高用户体验
4. 查询限制：考虑在MCP Server层面添加查询超时和结果集大小限制

总结

通过将Apache Doris MCP Server与Dify平台集成，企业可以快速构建智能数据查询系统，让非技术人员也能轻松获取数据分析结果。这种方案特别适合需要频繁进行数据查询的业务场景，能够显著提高工作效率。

后续可以考虑进一步优化，如添加查询缓存、支持更复杂的分析问题等，使系统能力更加强大。