feat: add mcp-servers/**

mcp-servers/clickhouse/.env.example

@@ -0,0 +1,14 @@
+# MCP ClickHouse Server Configuration
+# ===================================
+
+# MCP Service
+MCP_CLICKHOUSE_VERSION=latest
+MCP_CLICKHOUSE_PORT_OVERRIDE=8000
+
+# ClickHouse Connection
+CLICKHOUSE_URL=http://localhost:8123
+CLICKHOUSE_USER=default
+CLICKHOUSE_PASSWORD=
+
+# Timezone
+TZ=UTC

mcp-servers/clickhouse/README.md

@@ -0,0 +1,26 @@
+# ClickHouse MCP Server
+
+ClickHouse MCP Server provides integration with ClickHouse analytics database through the Model Context Protocol.
+
+## Features
+
+- 📊 **Database Queries** - Execute queries against ClickHouse
+- 📈 **Analytics** - Analyze data using ClickHouse capabilities
+- 🔍 **Data Exploration** - Explore database structure and data
+- 📉 **Performance** - Fast analytical queries on large datasets
+
+## Environment Variables
+
+| Variable                       | Default                 | Description                  |
+| ------------------------------ | ----------------------- | ---------------------------- |
+| `MCP_CLICKHOUSE_VERSION`       | `latest`                | MCP ClickHouse image version |
+| `MCP_CLICKHOUSE_PORT_OVERRIDE` | `8000`                  | MCP service port             |
+| `CLICKHOUSE_URL`               | `http://localhost:8123` | ClickHouse URL               |
+| `CLICKHOUSE_USER`              | `default`               | Database user                |
+| `CLICKHOUSE_PASSWORD`          | -                       | Database password            |
+| `TZ`                           | `UTC`                   | Timezone                     |
+
+## Quick Start
+
+```bash
+docker compose up -d

mcp-servers/clickhouse/README.zh.md

@@ -0,0 +1,27 @@
+# ClickHouse MCP 服务器
+
+ClickHouse MCP 服务器通过 Model Context Protocol 提供与 ClickHouse 分析数据库的集成。
+
+## 功能特性
+
+- 📊 **数据库查询** - 对 ClickHouse 执行查询
+- 📈 **数据分析** - 使用 ClickHouse 功能进行数据分析
+- 🔍 **数据探索** - 探索数据库结构和数据
+- 📉 **性能** - 对大型数据集进行快速分析查询
+
+## 环境变量
+
+| 变量                           | 默认值                  | 说明                    |
+| ------------------------------ | ----------------------- | ----------------------- |
+| `MCP_CLICKHOUSE_VERSION`       | `latest`                | MCP ClickHouse 镜像版本 |
+| `MCP_CLICKHOUSE_PORT_OVERRIDE` | `8000`                  | MCP 服务端口            |
+| `CLICKHOUSE_URL`               | `http://localhost:8123` | ClickHouse URL          |
+| `CLICKHOUSE_USER`              | `default`               | 数据库用户              |
+| `CLICKHOUSE_PASSWORD`          | -                       | 数据库密码              |
+| `TZ`                           | `UTC`                   | 时区                    |
+
+## 快速开始
+
+```bash
+docker compose up -d
+```

mcp-servers/clickhouse/docker-compose.yaml

@@ -0,0 +1,34 @@
+x-default: &default
+  restart: unless-stopped
+  logging:
+    driver: json-file
+    options:
+      max-size: 100m
+      max-file: "3"
+
+services:
+  mcp-clickhouse:
+    <<: *default
+    image: mcp/clickhouse:${MCP_CLICKHOUSE_VERSION:-latest}
+    environment:
+      - CLICKHOUSE_URL=${CLICKHOUSE_URL:-http://localhost:8123}
+      - CLICKHOUSE_USER=${CLICKHOUSE_USER:-default}
+      - CLICKHOUSE_PASSWORD=${CLICKHOUSE_PASSWORD:-}
+      - MCP_HOST=0.0.0.0
+      - TZ=${TZ:-UTC}
+    ports:
+      - "${MCP_CLICKHOUSE_PORT_OVERRIDE:-8000}:8000"
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:8000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    deploy:
+      resources:
+        limits:
+          cpus: '1.00'
+          memory: 512M
+        reservations:
+          cpus: '0.25'
+          memory: 128M