> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickHouse MCP 集成

> 选择 MCP 客户端或框架，将 AI 助手连接到 ClickHouse。

export const McpGuideGrid = ({variant = "guides"}) => {
  const clients = [{
    name: "Claude Code",
    logo: "/images/logo-claudecode-color.svg"
  }, {
    name: "Claude Desktop",
    logo: "/images/logo-claude.svg"
  }, {
    name: "ChatGPT",
    logo: "/images/logo-codex.svg"
  }, {
    name: "Cursor",
    logo: "/images/logo-cursor.webp"
  }, {
    name: "Windsurf",
    logo: "/images/logo-windsurf.svg"
  }];
  const guides = [{
    name: "Streamlit",
    logo: "/images/mcp-integrations/streamlit.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit")
  }, {
    name: "LangChain and LangGraph",
    logo: "/images/integrations/logos/langchain.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain"),
    lightInvert: true
  }, {
    name: "LlamaIndex",
    logo: "/images/mcp-integrations/llamaindex.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex")
  }, {
    name: "PydanticAI",
    logo: "/images/mcp-integrations/pydantic-ai.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai")
  }, {
    name: "SlackBot",
    logo: "/images/mcp-integrations/slack.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot")
  }, {
    name: "Agno",
    logo: "/images/mcp-integrations/agno.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno")
  }, {
    name: "Chainlit",
    logo: "/images/mcp-integrations/chainlit.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit")
  }, {
    name: "Claude Agent SDK",
    logo: "/images/logo-claude.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk")
  }, {
    name: "CopilotKit",
    logo: "/images/mcp-integrations/copilotkit.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit")
  }, {
    name: "CrewAI",
    logo: "/images/mcp-integrations/crewai.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai")
  }, {
    name: "DSPy",
    logo: "/images/mcp-integrations/dspy.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy")
  }, {
    name: "mcp-agent",
    logo: "/images/mcp-integrations/mcp-agent.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent")
  }, {
    name: "Microsoft Agent Framework",
    logo: "/images/mcp-integrations/microsoft-agent-framework.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework")
  }, {
    name: "Upsonic",
    logo: "/images/mcp-integrations/upsonic.jpg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic")
  }, {
    name: "OpenAI Agents SDK",
    logo: "/images/logo-codex.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents")
  }, {
    name: "Ollama",
    logo: "/images/mcp-integrations/ollama.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ollama")
  }, {
    name: "AnythingLLM",
    logo: "/images/mcp-integrations/anythingllm.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/anythingllm")
  }, {
    name: "Jan.ai",
    logo: "/images/mcp-integrations/jan.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/janai")
  }, {
    name: "LibreChat",
    logo: "/images/mcp-integrations/librechat.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/librechat")
  }, {
    name: "Open WebUI",
    logo: "/images/mcp-integrations/open-webui.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/open-webui")
  }];
  if (variant === "clients") {
    return <div className="card not-prose contents">
        <a href={localizeHref("/guides/use-cases/ai-ml/MCP/claude-desktop")} className="block no-underline focus:no-underline focus-visible:no-underline" style={{
      textDecoration: "none",
      outline: "none"
    }}>
          <div className="flex min-h-[112px] flex-col items-center gap-5 rounded-xl border border-gray-200 bg-white p-5 shadow-sm dark:border-white/10 dark:bg-[#282828] md:flex-row md:justify-between">
            <div className="text-center md:text-left">
              <div className="text-base font-semibold text-black dark:text-white">配置 ClickHouse MCP 服务器</div>
              <div className="mt-1 text-sm text-gray-600 dark:text-gray-400">Claude Code, Claude Desktop, Codex, ChatGPT, Cursor, and Windsurf</div>
            </div>

            <div className="flex flex-wrap items-center justify-center gap-2">
              {clients.map(client => <img key={client.name} src={client.logo} alt={`${client.name} 徽标`} title={client.name} className="h-8 w-8 object-contain" style={{
      pointerEvents: "none"
    }} />)}
            </div>
          </div>
        </a>
      </div>;
  }
  return <div className="my-8 grid grid-cols-2 gap-4 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6">
      {guides.map(guide => <div key={guide.href} className="card not-prose contents">
          <a href={guide.href} className="block no-underline focus:no-underline focus-visible:no-underline" style={{
    textDecoration: "none",
    outline: "none"
  }}>
            <div className="flex aspect-square min-h-[120px] flex-col items-center justify-center rounded-xl border border-gray-200 bg-white p-4 text-center shadow-sm dark:border-white/10 dark:bg-[#282828]">
              {guide.lightInvert ? <img src={guide.logo} alt={`${guide.name} logo`} className="ch-logo-invert h-16 w-16 object-contain" style={{
    pointerEvents: "none"
  }} /> : <img src={guide.logo} alt={`${guide.name} logo`} className="h-16 w-16 object-contain" style={{
    pointerEvents: "none"
  }} />}
              <div className="mt-3 text-sm font-semibold text-black dark:text-white">{guide.name}</div>
            </div>
          </a>
        </div>)}
    </div>;
};

ClickHouse MCP 服务器可将兼容的 AI 助手连接到 ClickHouse 数据库和工具。
有关该协议、其架构及 ClickHouse MCP 服务器的介绍，请参阅 [模型上下文协议 (MCP) 概述](/zh/concepts/features/interfaces/mcp)。

<div id="set-up-clickhouse-mcp-server">
  ## 设置 ClickHouse MCP 服务器
</div>

选择您的 MCP 客户端，然后按照 [ClickHouse MCP 服务器设置指南](/zh/guides/use-cases/ai-ml/MCP/claude-desktop) 将其连接至 ClickHouse。

<McpGuideGrid variant="clients" />

<div id="clickhouse-mcp-server-guides">
  ## 使用 ClickHouse MCP 服务器的指南
</div>

选择一个集成或框架，查看其 ClickHouse MCP 指南。

<McpGuideGrid />

<Info>
  第三方徽标和商标归其各自所有者所有，仅用于标识这些集成。
</Info>