Meside：数据库AI Agent MCP 服务器

项目简介

Meside 是一个开源的 AI 驱动的数据转换工具，它也实现了 Model Context Protocol (MCP) 服务器，旨在为 AI Agent 提供数据库上下文和工具能力。Meside 可以连接多种数据库，并提供查询数据库信息、执行 SQL 查询等工具，方便 LLM 客户端进行数据库操作和数据分析。

主要功能点

资源管理 (Resources): 通过仓库 (Warehouse) 的概念管理和连接 PostgreSQL, BigQuery, MySQL, OracleDB 等多种数据库。
工具注册和执行 (Tools):
- 'get-warehouses': 列出所有已配置的数据库仓库。
- 'get-tables': 列出指定数据库仓库中的所有表。
- 'get-columns': 列出指定数据库仓库和表中的所有列及其详细信息（类型、描述等）。
- 'query': 在指定的数据库仓库中执行 SQL 查询。
SSE MCP 协议支持: 使用 SSE (Server-Sent Events) 协议与 MCP 客户端通信。

安装步骤

前提条件: 确保已安装 Bun (v1.0+) 和 Docker。
数据库启动: 运行 'sh ./dev-docker-start.sh' 启动开发环境所需的数据库 Docker 容器。

后端设置:

cd ./server
cp .env.default .env
echo 'AI_MODEL=o3-mini' >> .env  # 可选AI模型配置
echo 'OPENAI_API_KEY=<your-api-key>' >> .env # 如果使用 OpenAI 模型，配置 API 密钥
bun install        # 安装依赖
bun run migrate    # 初始化数据库
bun run seed       # 加载示例数据
bun run dev        # 启动后端服务器

前端设置 (可选): 如果需要运行前端界面：

cd ./frontend
bun install
bun run dev        # 启动前端客户端

服务器配置 (MCP 客户端配置)

MCP 客户端需要配置 Meside MCP 服务器的连接信息。以下是一个示例 JSON 配置，用于配置 Cursor 或其他支持 MCP 的 IDE：

{
  "mcpServers": {
    "database": {
      "url": "http://localhost:6333/meside/api/mcp-server/sse"
    }
  }
}

'mcpServers': 定义 MCP 服务器配置的对象。
- 'database': 服务器名称，可以自定义。
  - 'url': Meside MCP 服务器的 SSE 端点 URL。默认情况下，Meside 服务器运行在 'http://localhost:6333'，MCP SSE 端点路径为 '/meside/api/mcp-server/sse'。请根据实际部署情况修改主机和端口。

基本使用方法

启动 Meside 服务器 (server)。
在支持 MCP 协议的客户端（如 Cursor IDE）中，配置上述服务器配置信息。
客户端将能够发现 Meside 服务器提供的工具，并可以通过自然语言指令调用这些工具来查询和操作数据库。例如，在 Cursor 中可以使用 '/' 触发工具提示，并选择 Meside 提供的工具。

关键词

Meside：数据库AI Agent MCP 服务器

信息