CDM MCP Server

Name: CDM MCP Server
Author: kbase

本地服务

github.com/kbase数据库053 周前更新

代码仓库

关于 CDM MCP Server

CDM MCP Server 是基于 FastAPI 的服务，供开发者在本地开发或评估时通过 Spark 操作 MinIO 中的 Delta Lake 表。它支持自然语言数据操作，但文档明确不批准用于生产环境。

主要功能

01通过 Spark 访问 Delta Lake 表
02使用 MinIO 存储数据
03支持自然语言数据操作
04提供 FastAPI 服务

适用场景

01本地评估 Delta Lake 数据操作
02在开发环境中查询测试表

MCP 相关

该服务实现 MCP，供 MCP 主机将自然语言请求用于 Delta Lake 表操作。查询结果会发送给模型主机，除非模型在本地运行；项目仅限本地开发或评估。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cdm": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "network"
      ]
    }
  }
}

启动命令docker run -i --rm network

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocinetworkstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

CDM MCP 服务

一个基于 FastAPI 的服务，通过 Spark 让 AI 助手能够与存储在 MinIO 中的 Delta Lake 表进行交互，并实现用于自然语言数据操作的 Model Context Protocol（MCP）。

⚠️ 重要警告：

此服务允许对 Delta Lake 表执行任意只读查询。查询结果将发送到模型托管服务器，除非你在本地托管模型。

❌ 此外，在获得 KBase 领导层的明确批准之前，此服务不得部署到任何生产环境，包括 CI。仅可用于本地开发或评估。

文档

详细文档请参阅用户指南。指南涵盖：

快速入门 - 启动并运行本地服务
创建示例 Delta 表 - 设置本地测试数据
使用 API - 直接使用 API 的示例
AI 助手集成 - 配置 MCP Host 工具并使用
- MCP 配置 - 创建 mcp.json
- MCP Host 设置 - 配置 MCP Host
- 提示词示例 - 自然语言示例

快速入门

克隆代码库：

git clone https://github.com/kbase/cdm-mcp-server.git
cd cdm-mcp-server

创建所需目录：

mkdir -p cdr/cdm/jupyter/cdm_shared_workspace

创建 Docker 网络：

docker network create cdm-jupyterhub-network

启动服务：
```
docker-compose up -d --build
```
访问服务：
- MCP 服务：http://localhost:8000/docs
- MinIO 控制台：http://localhost:9003
- Spark Master UI：http://localhost:8090
- JupyterHub：http://localhost:4043

测试

# Install dependencies (only required on first run or when the uv.lock file changes)
uv sync --locked

# Run tests
PYTHONPATH=. uv run pytest tests

# Run with coverage
PYTHONPATH=. uv run pytest --cov=src tests/

支持 Markdown

登录后评论