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

# MCP 指南

> 本页简要介绍 Model Context Protocol (MCP)，并提供 MCP 指南的目录。

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

[Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP) 是由 Anthropic 开发的一项标准，使 AI 助手能够与外部系统无缝集成。
该协议允许 AI 助手以安全且标准化的方式连接到数据源、API、数据库等。

MCP 在 AI 模型与各种服务之间建立了一个通用接口，无需再为每种集成单独实现自定义工具。
你可以将它理解为专为 AI 系统设计的一套通用 API 标准。

MCP 的关键优势在于，AI 库只需针对该协议实现一次支持。
之后，所有兼容 MCP 的服务都可立即接入，从而为 AI 库维护者节省大量时间。

<div id="mcp-architecture">
  ## MCP 的架构是什么？
</div>

MCP 采用客户端-服务器架构：

* 客户端 (如 Claude Desktop、Cursor 或 VS Code) 会与 MCP 服务器建立连接。你可以在 GitHub 仓库 [awesome-mcp-clients](https://github.com/punkpeye/awesome-mcp-clients?tab=readme-ov-file#windsurf) 中查看客户端汇总。
* 服务器通过标准化接口提供工具和能力。你可以在 GitHub 仓库 [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) 中查看服务器汇总。
* 随后，AI 模型便可在需要时使用这些工具来访问外部数据和功能。

下图展示了该架构：

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/MCP/mcp_overview.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=5b034a203fb07ffbb26c2b5ef2cff1b8" alt="MCP 概览" size="lg" width="1551" height="641" data-path="images/use-cases/AI_ML/MCP/mcp_overview.webp" />

<div id="clickhouse-mcp-server">
  ## ClickHouse 有 MCP 服务器吗？
</div>

有！
[ClickHouse MCP 服务器](https://github.com/ClickHouse/mcp-clickhouse)提供以下工具：

* `run_select_query` - 在你的 ClickHouse 集群上执行 SQL 查询。
* `list_databases` - 列出你的 ClickHouse 集群中的所有数据库。
* `list_tables` - 列出某个数据库中的所有表。

如果你在寻找 ClickHouse Cloud 中的远程 MCP 服务器，请参阅["Cloud 中的远程 MCP 服务器"](/zh/products/cloud/features/ai-ml/remote-mcp)页面

<Tip>
  **Agent 技能**

  [ClickHouse Agent Skills 仓库](https://github.com/ClickHouse/agent-skills)提供了一套封装好的说明，可为 AI 编码智能体 (Claude Code、Cursor、Copilot 等) 补充特定领域的专业能力。该仓库为 ClickHouse 数据库提供相关技能，涵盖 schema 设计、查询优化和数据摄取模式。
</Tip>

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

以下是一些介绍如何使用 ClickHouse MCP 服务器的指南。

| 页面                                                                                                                                          | 说明                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [如何使用 Streamlit 构建由 ClickHouse 驱动的 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit)                                     | 了解如何使用 Streamlit 和 ClickHouse MCP 服务器构建基于 Web 的 AI 智能体                                    |
| [如何使用 ClickHouse MCP 服务器构建 LangChain/LangGraph AI agent。](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain)                      | 了解如何使用 ClickHouse MCP 服务器构建可与 ClickHouse SQL Playground 交互的 LangChain/LangGraph AI agent。 |
| [如何基于 ClickHouse MCP 服务器构建 LlamaIndex AI 智能体。](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex)                                | 了解如何构建可与 ClickHouse MCP 服务器交互的 LlamaIndex AI 智能体。                                         |
| [如何使用 ClickHouse MCP 服务器构建 PydanticAI agent。](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai)                                | 了解如何构建可与 ClickHouse MCP 服务器交互的 PydanticAI agent。                                          |
| [如何使用 ClickHouse MCP 服务器构建 SlackBot agent。](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot)                                     | 了解如何构建可与 ClickHouse MCP 服务器交互的 SlackBot agent。                                            |
| [如何使用 Agno 和 ClickHouse MCP 服务器构建 AI Agent](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno)                                         | 了解如何使用 Agno 和 ClickHouse MCP 服务器构建 AI Agent                                               |
| [如何使用 Chainlit 和 ClickHouse MCP 服务器构建 AI agent](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit)                                 | 了解如何使用 Chainlit 搭配 ClickHouse MCP 服务器构建基于 LLM 的聊天应用                                       |
| [如何借助 Claude Agent SDK 和 ClickHouse MCP 服务器构建 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk)                   | 了解如何借助 Claude Agent SDK 和 ClickHouse MCP 服务器构建 AI 智能体                                     |
| [如何使用 CopilotKit 和 ClickHouse MCP 服务器构建 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit)                               | 了解如何借助 ClickHouse MCP 和 CopilotKit，利用存储在 ClickHouse 中的数据构建智能体应用                           |
| [如何使用 CrewAI 和 ClickHouse MCP 服务器构建 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai)                                       | 了解如何使用 CrewAI 和 ClickHouse MCP 服务器构建 AI 智能体                                               |
| [如何使用 DSPy 和 ClickHouse MCP 服务器构建 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy)                                           | 了解如何使用 DSPy 和 ClickHouse MCP 服务器构建 AI 智能体                                                 |
| [如何使用 mcp-agent 和 ClickHouse MCP 服务器构建 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent)                                 | 了解如何使用 mcp-agent 和 ClickHouse MCP 服务器构建 AI 智能体                                            |
| [如何使用 Microsoft Agent Framework 和 ClickHouse MCP 服务器构建 AI 智能体](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework) | 了解如何使用 Microsoft Agent Framework 和 ClickHouse MCP 服务器构建 AI 智能体                            |
| [如何使用 Upsonic 和 ClickHouse MCP 服务器构建 AI agent](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic)                                   | 了解如何使用 Upsonic 和 ClickHouse MCP 服务器构建 AI agent                                            |
| [如何使用 ClickHouse MCP 服务器构建 OpenAI agent。](/zh/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents)                                  | 了解如何构建一个可与 ClickHouse MCP 服务器交互的 OpenAI agent。                                            |
| [使用 Ollama 搭建 ClickHouse MCP 服务器](/zh/guides/use-cases/ai-ml/MCP/ollama)                                                                    | 本指南说明如何使用 Ollama 搭建 ClickHouse MCP 服务器。                                                   |
| [结合 AnythingLLM 和 ClickHouse Cloud 设置 ClickHouse MCP 服务器](/zh/guides/use-cases/ai-ml/MCP/anythingllm)                                       | 本指南介绍如何使用 Docker 为 AnythingLLM 配置 ClickHouse MCP 服务器。                                     |
| [为 Claude Desktop 配置 ClickHouse MCP 服务器](/zh/guides/use-cases/ai-ml/MCP/claude-desktop)                                                     | 本指南介绍如何为 Claude Desktop 配置 ClickHouse MCP 服务器。                                            |
| [将 ClickHouse MCP 服务器与 Jan.ai 搭配使用](/zh/guides/use-cases/ai-ml/MCP/janai)                                                                   | 本指南介绍如何将 Jan.ai 与 ClickHouse MCP 服务器集成。                                                   |
| [在 LibreChat 中使用 ClickHouse MCP 服务器](/zh/guides/use-cases/ai-ml/MCP/librechat)                                                              | 本指南介绍如何使用 Docker 将 LibreChat 与 ClickHouse MCP 服务器集成。                                      |
| [在 Open WebUI 中使用 ClickHouse MCP 服务器](/zh/guides/use-cases/ai-ml/MCP/open-webui)                                                            | 本指南介绍如何使用 Docker 设置 Open WebUI，并将其与 ClickHouse MCP 服务器集成。                                 |