> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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) は、AIアシスタントが外部システムとシームレスに連携できるようにする、Anthropicが開発した標準です。
このプロトコルにより、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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/mcp_overview.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=bee0beef935d6b4e927e623ec66d4ed4" 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 の Remote MCPサーバー"](/docs/ja/products/cloud/features/ai-ml/remote-mcp) のページをご覧ください。

<Tip>
  **Agent Skills**

  [ClickHouse Agent Skills repo](https://github.com/ClickHouse/agent-skills) は、AI コーディングエージェント (Claude Code、Cursor、Copilot など) にドメイン固有の専門知識を追加する、パッケージ化された手順を提供します。このリポジトリには、スキーマ設計、クエリ最適化、データのインジェストパターンなど、ClickHouse データベース向けのスキルが用意されています。
</Tip>

<div id="clickhouse-mcp-server-guides">
  ## ClickHouse MCPサーバーの利用ガイド
</div>

以下では、ClickHouse MCPサーバーの使い方を紹介します。

| ページ                                                                                                                                               | 説明                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| [Streamlit を使って ClickHouse をバックエンドとする AI エージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit)                              | Streamlit と ClickHouse MCP server を使って Web ベースの AI エージェントを構築する方法を学びます                                    |
| [ClickHouse MCP server を使用して LangChain/LangGraph の AIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain)                  | ClickHouse の MCPサーバーを使用して ClickHouse の SQL Playground と連携できる LangChain/LangGraph の AIエージェントを構築する方法を学びます。 |
| [ClickHouse MCP serverを使用したLlamaIndex AIエージェントの構築方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex)                                | ClickHouse MCP serverと連携できるLlamaIndex AIエージェントの構築方法を学べます。                                                |
| [ClickHouse MCP server を使って PydanticAI エージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai)                              | ClickHouse MCP server と連携できる PydanticAI エージェントの構築方法を学びます。                                                |
| [ClickHouse MCP server を使って SlackBot エージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot)                                   | ClickHouse MCP server と連携できる SlackBotエージェントの構築方法を学びます。                                                   |
| [Agno と ClickHouse MCP server を使って AIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno)                                       | Agno と ClickHouse MCP server を使って AIエージェントを構築する方法を学びます。                                                  |
| [Chainlit と ClickHouse MCP server を使って AI エージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit)                              | Chainlit を使って ClickHouse MCP server と連携した LLM ベースのチャットアプリを構築する方法を学びましょう                                  |
| [Claude Agent SDKとClickHouse MCP serverを使用してAIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk)                  | Claude Agent SDKとClickHouse MCP serverを使用してAIエージェントを構築する方法を学びます                                          |
| [CopilotKit と ClickHouse MCPサーバーを使って AI エージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit)                              | ClickHouse に保存されたデータを ClickHouse MCP と CopilotKit で活用して、エージェント型アプリケーションを構築する方法を学びます                      |
| [CrewAIとClickHouse MCPサーバーを使ってAIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai)                                          | CrewAIとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学ぶ                                                          |
| [DSPyとClickHouse MCPサーバーを使ってAIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy)                                              | DSPy と ClickHouse MCP server を使用して AIエージェントを構築する方法を学べます                                                  |
| [mcp-agent と ClickHouse MCP server を使用して AIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent)                            | mcp-agent と ClickHouse MCP server を使用して AIエージェントを構築する方法を学べます                                             |
| [Microsoft Agent Framework と ClickHouse MCPサーバーを使って AIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework) | Microsoft Agent Framework と ClickHouse MCPサーバーを使って AIエージェントを構築する方法を学びましょう                                |
| [UpsonicとClickHouse MCP serverを使ってAIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic)                                     | UpsonicとClickHouse MCP serverを使ってAIエージェントを構築する方法を学びます                                                    |
| [ClickHouse MCP serverを使用してOpenAIエージェントを構築する方法](/docs/ja/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents)                                  | ClickHouse MCPサーバーと対話できる OpenAI エージェントの構築方法を学びます。                                                        |
| [Ollama で ClickHouse MCPサーバーをセットアップする](/docs/ja/guides/use-cases/ai-ml/MCP/ollama)                                                                     | このガイドでは、Ollama で ClickHouse MCPサーバーをセットアップする方法を説明します。                                                    |
| [AnythingLLMでClickHouse MCPサーバーを使用する](/docs/ja/guides/use-cases/ai-ml/MCP/anythingllm)                                                                 | このガイドでは、Docker を使用して ClickHouse MCPサーバーで AnythingLLM をセットアップする方法を説明します。                                  |
| [Claude DesktopでClickHouse MCPサーバーを使用する](/docs/ja/guides/use-cases/ai-ml/MCP/claude-desktop)                                                           | このガイドでは、Claude DesktopでClickHouse MCPサーバーを設定する方法を説明します。                                                  |
| [Jan.aiでClickHouse MCPサーバーを使用する](/docs/ja/guides/use-cases/ai-ml/MCP/janai)                                                                            | このガイドでは、Jan.ai と ClickHouse MCPサーバーを連携する方法を説明します。                                                        |
| [LibreChat で ClickHouse MCPサーバーを使用する](/docs/ja/guides/use-cases/ai-ml/MCP/librechat)                                                                   | このガイドでは、Docker を使って LibreChat と ClickHouse MCPサーバーを連携する方法を説明します。                                         |
| [Open WebUI で ClickHouse MCPサーバーを使用する](/docs/ja/guides/use-cases/ai-ml/MCP/open-webui)                                                                 | このガイドでは、Docker を使用して Open WebUI と ClickHouse MCPサーバーをセットアップする方法を説明します。                                   |
