WIP: MCP Server Superset

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

项目简介

这是一个基于Apache Superset REST API的MCP实现，通过大型模型提供基本查询能力。

特性

• 查询数据库
• 查找表
• 查询字段
• 执行SQL

环境需求

• Node.js >= 14.0.0

快速开始

直接使用

npx -y https://github.com/LiusCraft/superset-mcp-server

SUPERSET_URL
SUPERSET_USERNAME
SUPERSET_PASSWORD

鉴权方式：ldap

安装依赖

# 安装 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. 构建项目

2. 设置mcp配置：

node currentFolder/build/index.js

3. 使用mcp

贡献指南

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

许可证

Apache License 2.0

联系信息

如果有任何问题，请提交issue或联系项目维护者。 </中文翻译>