mcpField
W
WIP: MCP Server Superset

WIP: MCP Server Superset

本地服务
github.com/LiusCraft数据与分析581 周前更新
代码仓库

关于 WIP: MCP Server Superset

WIP: MCP Server Superset 是基于 Apache Superset REST API 的 MCP 服务，面向需要通过 LLM 查询 Superset 数据的用户。它提供数据库、表和字段查询，以及 SQL 执行能力。

主要功能

  1. 01查询数据库
  2. 02查询表
  3. 03查询字段
  4. 04执行 SQL

适用场景

  1. 01查看 Superset 中的数据库
  2. 02检索表和字段信息
  3. 03通过 SQL 查询数据

MCP 相关

该 MCP 服务将 Apache Superset REST API 的数据库、表、字段查询和 SQL 执行能力提供给 MCP 客户端。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "superset": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/LiusCraft/superset-mcp-server"
      ]
    }
  }
}
启动命令npx -y https://github.com/LiusCraft/superset-mcp-server

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

安装包
npmsuperset-mcp-server

工具

还没有获取到工具列表

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

详细介绍

来自项目 README

WIP: MCP Server Superset

基于 Apache Superset REST API 构建的 Model Context Protocol (MCP) 服务器端应用。

项目简介

这是一个基于 Apache Superset RESTAPI 在MCP上实现了通过大模型来让它进行基本的查询能力。

功能特性

  • 查询数据库
  • 查询表
  • 查询字段
  • 执行sql

环境要求

  • Node.js >= 14.0.0

快速开始

直接使用
npx -y https://github.com/LiusCraft/superset-mcp-server

SUPERSET_URL
SUPERSET_USERNAME
SUPERSET_PASSWORD

鉴权方式：ladp
安装依赖
# 安装 Node.js 依赖
npm install
启动服务
# api client 测试
npm run src/examples/superset-example.ts

# 调试环境
npm run inspector

# 生产环境
npm run build
npm start

配置说明

项目配置文件位于 config 目录下，包括：

  • 数据库配置
  • API 配置
  • 安全配置

API 文档

参考superset官方 swagger文档

开发指南

目录结构
.
├── src/          # 源代码目录
├── src/examples          # 封装的api客户端测试代码
├── src/services          # 封装的api函数
├── src/utils             # 封装的superset baseHttpClient
├── src/index.ts          # 定义mcp接口
开发规范
  • 遵循 ESLint 规范
  • 使用 TypeScript 进行开发
  • 遵循 Git Flow 工作流

部署

mcp 部署

  1. build the project

  2. set mcp config:

node currentFolder/build/index.js
  1. use the mcp

贡献指南

  1. Fork 本仓库
  2. 创建特性分支
  3. 提交变更
  4. 发起 Pull Request

许可证

Apache License 2.0

联系方式

如有问题，请提交 Issue 或联系项目维护者。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。