> ## 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
{alt}
; }; [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP)은 AI 어시스턴트가 외부 시스템과 원활하게 통합할 수 있도록 Anthropic이 개발한 표준입니다. 이 프로토콜을 사용하면 AI 어시스턴트가 데이터 소스, API, 데이터베이스 등과 안전하고 표준화된 방식으로 연결됩니다. MCP는 AI 모델과 다양한 서비스 사이에 범용 인터페이스를 제공하여 각 통합마다 별도의 맞춤형 도구를 구현할 필요를 없앱니다. 즉, AI 시스템을 위해 특별히 설계된 범용 API 표준으로 볼 수 있습니다. MCP의 가장 큰 장점은 AI 라이브러리에서 이 프로토콜을 한 번만 지원하면 된다는 점입니다. 그 이후에는 모든 MCP 호환 서비스를 즉시 사용할 수 있어, AI 라이브러리 유지 관리자의 시간을 크게 절약할 수 있습니다.
## MCP 아키텍처는 무엇인가요?
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 모델은 필요할 때 이러한 도구를 사용해 외부 데이터와 기능에 액세스할 수 있습니다. 아래는 이 아키텍처를 보여주는 다이어그램입니다. MCP 개요
## ClickHouse에는 MCP 서버가 있나요?
있습니다! [ClickHouse MCP 서버](https://github.com/ClickHouse/mcp-clickhouse)는 다음 도구를 제공합니다. * `run_select_query` - ClickHouse 클러스터에서 SQL 쿼리를 실행합니다. * `list_databases` - ClickHouse 클러스터의 모든 데이터베이스를 나열합니다. * `list_tables` - 데이터베이스의 모든 테이블을 나열합니다. ClickHouse Cloud의 원격 MCP 서버를 찾는다면 ["Cloud의 원격 MCP 서버"](/docs/ko/products/cloud/features/ai-ml/remote-mcp) 페이지를 참조하십시오. **Agent Skills** [ClickHouse Agent Skills 리포지토리](https://github.com/ClickHouse/agent-skills)는 AI 코딩 에이전트(Claude Code, Cursor, Copilot 등)에 도메인 특화 전문성을 더해 주는 패키지된 지침을 제공합니다. 이 리포지토리는 ClickHouse 데이터베이스용 스킬을 제공하며, 스키마 설계, 쿼리 최적화, 데이터 수집 패턴을 다룹니다.
## ClickHouse MCP 서버 사용 가이드
아래에는 ClickHouse MCP 서버 사용 방법을 설명하는 몇 가지 가이드가 있습니다. | 페이지 | 설명 | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | [Streamlit으로 ClickHouse 기반 AI Agent 구축하기](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit) | Streamlit과 ClickHouse MCP 서버를 사용해 웹 기반 AI Agent를 구축하는 방법을 알아보세요 | | [ClickHouse MCP 서버를 사용하여 ClickHouse의 SQL Playground와 상호작용하는 LangChain/LangGraph AI 에이전트 구축 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain) | ClickHouse MCP 서버를 사용하여 ClickHouse의 SQL Playground와 상호작용하는 LangChain/LangGraph AI 에이전트 구축 방법을 알아보세요. | | [ClickHouse MCP 서버를 사용해 LlamaIndex AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex) | ClickHouse MCP 서버와 상호작용할 수 있는 LlamaIndex AI 에이전트를 구축하는 방법을 알아보세요. | | [ClickHouse MCP 서버를 사용하여 PydanticAI agent를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai) | ClickHouse MCP 서버와 상호작용할 수 있는 PydanticAI agent를 구축하는 방법을 알아보세요. | | [ClickHouse MCP 서버를 사용하여 SlackBot agent를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot) | ClickHouse MCP 서버와 상호작용하는 SlackBot 에이전트를 구축하는 방법을 알아보십시오. | | [Agno와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno) | Agno와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법을 알아보십시오. | | [Chainlit과 ClickHouse MCP 서버로 AI 에이전트 구축하기](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit) | Chainlit을 사용해 ClickHouse MCP 서버와 함께 LLM 기반 채팅 앱을 구축하는 방법을 알아보세요 | | [Claude Agent SDK와 ClickHouse MCP 서버로 AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk) | Claude Agent SDK와 ClickHouse MCP 서버로 AI 에이전트를 구축하는 방법을 알아보세요 | | [CopilotKit과 ClickHouse MCP 서버로 AI 에이전트 구축하기](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit) | ClickHouse MCP와 CopilotKit을 사용해 ClickHouse에 저장된 데이터로 에이전트 기반 애플리케이션을 구축하는 방법을 알아보세요 | | [CrewAI와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai) | CrewAI와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법을 알아보세요 | | [DSPy와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy) | DSPy와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법을 알아보세요 | | [mcp-agent와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent) | mcp-agent와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법을 알아보세요 | | [Microsoft Agent framework와 ClickHouse MCP 서버를 사용해 AI 에이전트 구축하기](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework) | Microsoft Agent framework와 ClickHouse MCP 서버를 사용해 AI 에이전트를 구축하는 방법을 알아보세요 | | [Upsonic과 ClickHouse MCP 서버로 AI 에이전트를 구축하는 방법](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic) | Upsonic과 ClickHouse MCP 서버로 AI 에이전트를 구축하는 방법을 알아보십시오 | | [ClickHouse MCP 서버를 사용하여 OpenAI 에이전트를 구축하는 방법.](/docs/ko/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents) | ClickHouse MCP 서버와 상호작용할 수 있는 OpenAI agent를 구축하는 방법을 알아보세요. | | [Ollama로 ClickHouse MCP 서버 설정하기](/docs/ko/guides/use-cases/ai-ml/MCP/ollama) | 이 가이드에서는 ClickHouse MCP 서버와 함께 Ollama를 설정하는 방법을 설명합니다. | | [AnythingLLM과 함께 ClickHouse MCP 서버 사용하기](/docs/ko/guides/use-cases/ai-ml/MCP/anythingllm) | 이 가이드에서는 Docker를 사용하여 ClickHouse MCP 서버와 함께 AnythingLLM을 설정하는 방법을 설명합니다. | | [Claude Desktop과 함께 ClickHouse MCP 서버 사용하기](/docs/ko/guides/use-cases/ai-ml/MCP/claude-desktop) | 이 가이드에서는 Claude Desktop과 함께 ClickHouse MCP 서버를 설정하는 방법을 설명합니다. | | [Jan.ai와 함께 ClickHouse MCP 서버 사용하기](/docs/ko/guides/use-cases/ai-ml/MCP/janai) | 이 가이드는 Jan.ai와 ClickHouse MCP 서버를 설정하는 방법을 설명합니다. | | [LibreChat과 함께 ClickHouse MCP 서버 사용하기](/docs/ko/guides/use-cases/ai-ml/MCP/librechat) | 이 가이드는 Docker를 사용해 LibreChat과 ClickHouse MCP 서버를 설정하는 방법을 설명합니다. | | [Open WebUI와 함께 ClickHouse MCP 서버 사용하기](/docs/ko/guides/use-cases/ai-ml/MCP/open-webui) | 이 가이드에서는 Docker를 사용해 Open WebUI와 ClickHouse MCP 서버를 설정하는 방법을 설명합니다. |