メインコンテンツへスキップ
メインコンテンツへスキップ

MCP ガイド

Model Context Protocol (MCP) は、AI アシスタントが外部システムとシームレスに統合できるようにするために Anthropic によって開発された標準プロトコルです。 このプロトコルにより、AI アシスタントはデータソース、API、データベースなどに、安全かつ標準化された方法で接続できるようになります。

MCP は、AI モデルとさまざまなサービスとの間に共通のインターフェースを提供し、統合ごとにカスタムのツール実装を行う必要性をなくします。 AI システム向けに特化して設計された、汎用的な API 標準と考えることができます。

MCP の主な利点は、AI ライブラリがこのプロトコルへの対応を一度実装するだけでよい点です。 一度対応すれば、すべての MCP 対応サービスに即座にアクセスできるようになり、AI ライブラリのメンテナーの作業コストを大幅に削減できます。

MCP のアーキテクチャとは?

MCP はクライアントサーバー型アーキテクチャに従います。

  • クライアント(Claude Desktop、Cursor、VS Code など)は MCP サーバーへの接続を確立します。awesome-mcp-clients GitHub リポジトリでクライアントの一覧を確認できます。
  • サーバーは標準化されたインターフェースを通じてツールや機能を公開します。awesome-mcp-servers GitHub リポジトリでサーバーの一覧を確認できます。
  • その後、AI モデルは必要に応じて、これらのツールを使って外部データや機能にアクセスできます。

以下はアーキテクチャを示した図です。

MCP の概要

ClickHouse には MCP サーバー はありますか?

はい、あります。 ClickHouse MCP サーバー は次のツールを提供します:

  • run_select_query - ClickHouse クラスター上で SQL クエリを実行します。
  • list_databases - ClickHouse クラスター上のすべてのデータベースを一覧表示します。
  • list_tables - データベース内のすべてのテーブルを一覧表示します。

ClickHouse Cloud でリモート MCP サーバーを探している場合は、"Remote MCP server in Cloud" のページを参照してください。

Agent Skills

ClickHouse Agent Skills リポジトリ は、AI コーディングエージェント (Claude Code、Cursor、Copilot など) を拡張してドメイン固有の専門知識を持たせるための、パッケージ化された指示セットを提供します。このリポジトリは ClickHouse データベース向けのスキルを提供しており、スキーマ設計、クエリ最適化、データのインジェストパターンをカバーします。

ClickHouse MCP サーバー の利用ガイド

以下に、ClickHouse MCP サーバー の使用方法を説明するガイドをいくつか示します。

ページ説明
StreamlitでClickHouseをバックエンドにしたAIエージェントを構築する方法StreamlitとClickHouse MCPサーバーを使って、WebベースのAIエージェントを構築する方法を学ぶ
ClickHouse MCPサーバーを使ってLangChain/LangGraphのAIエージェントを構築する方法ClickHouseのMCPサーバーを使ってClickHouseのSQL playgroundと連携できるLangChain/LangGraphのAIエージェントを構築する方法を学びます。
ClickHouse MCPサーバーを使ってLlamaIndex AIエージェントを構築する方法ClickHouse MCPサーバーと連携できるLlamaIndex AIエージェントの構築方法を学びます。
ClickHouse MCPサーバーを使ってPydanticAIエージェントを構築する方法ClickHouse MCPサーバーと連携するPydanticAIエージェントの構築方法を学びます。
ClickHouse MCPサーバーを使用したSlackBotエージェントの構築方法ClickHouse MCPサーバーと連携するSlackBotエージェントの構築方法を学びます。
AgnoとClickHouse MCPサーバーでAIエージェントを構築する方法AgnoとClickHouse MCPサーバーでAIエージェントを構築する方法を学びます
ChainlitとClickHouse MCPサーバーでAIエージェントを構築する方法Chainlitを使って、ClickHouse MCPサーバーと連携するLLMベースのチャットアプリを構築する方法を学ぶ
Claude Agent SDKとClickHouse MCPサーバーを使ってAIエージェントを構築する方法Claude Agent SDKとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学ぶ
CopilotKit と ClickHouse MCPサーバーで AIエージェントを構築する方法ClickHouse に保存されたデータを ClickHouse MCP と CopilotKit で活用して、エージェント型アプリケーションを構築する方法を学ぶ
CrewAI と ClickHouse MCPサーバーで AIエージェントを構築する方法CrewAIとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学ぶ
DSPyとClickHouse MCPサーバーを使ったAIエージェントの構築方法DSPyとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学ぶ
mcp-agentとClickHouse MCPサーバーを使ってAIエージェントを構築する方法mcp-agentとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学びます
Microsoft Agent FrameworkとClickHouse MCPサーバーを使ってAIエージェントを構築する方法Microsoft Agent frameworkとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学びます
UpsonicとClickHouse MCPサーバーを使ってAIエージェントを構築する方法UpsonicとClickHouse MCPサーバーを使ってAIエージェントを構築する方法を学びます
ClickHouse MCPサーバーを使ってOpenAIエージェントを構築する方法ClickHouse MCPサーバーと連携できるOpenAIエージェントの構築方法を学ぶ。
AnythingLLMとClickHouse CloudでClickHouse MCPサーバーをセットアップするこのガイドでは、Dockerを使ってAnythingLLMをClickHouse MCPサーバーと連携させてセットアップする方法を説明します。
Claude DesktopでClickHouse MCPサーバーをセットアップするこのガイドでは、Claude DesktopをClickHouse MCPサーバーと連携させてセットアップする方法を説明します。
Jan.aiでClickHouse MCPサーバーをセットアップするこのガイドでは、Jan.aiでClickHouse MCPサーバーをセットアップする方法を説明します。
LibreChatとClickHouse CloudでClickHouse MCPサーバーをセットアップするこのガイドでは、Dockerを使ってLibreChatをClickHouse MCPサーバーと連携させる方法を説明します。
OllamaでClickHouse MCPサーバーをセットアップするこのガイドでは、OllamaをClickHouse MCPサーバーと連携させる方法を説明します。
Open WebUIとClickHouse Cloudを使用してClickHouse MCPサーバーをセットアップするこのガイドでは、Dockerを使ってClickHouse MCPサーバーとOpen WebUIをセットアップする方法を説明します。