Inshow AI Query MCP

Inshow AI Query MCP 是一个基于 MCP (Model Context Protocol) 协议的supabase 服务，支持 Streamable HTTP 和 STDIO 两种运行模式，可用于 AI 辅助数据库查询和分析。

本项目仅作为MCP学习项目用途

功能特性

支持最新的 Streamable HTTP 协议（与 Cherry Studio 兼容）
支持 STDIO 模式，方便集成到其他应用
提供数据库查询工具
支持数据分析工具和提示
基于 Supabase 的数据存储

安装

# 克隆仓库
git clone https://github.com/zhycx1995/inshow-ai-query-mcp.git
cd inshow-ai-query-mcp

# 安装依赖
npm install

# 准备环境变量
cp .env.example .env
# 编辑 .env 文件，填入你的 Supabase 配置

使用方法

STDIO 模式 (默认)

npm start
# 或者
node src/index.js

STDIO inspector调试模式

npm run inspect

Streamable HTTP 模式

# 基本启动
npm start -- -m http -p 9000

# 带调试信息的启动
npm start -- -m http -p 9000 -d

# 完整配置启动
npm start -- -m http -p 9000 -d --allow-anonymous --session-timeout 60

命令行参数

参数	说明	默认值
`-p, --port <number>`	服务端口号	`9000`
`-m, --mode <string>`	运行模式 (stdio\	http)	`stdio`
`-d, --debug`	启用调试模式	`false`
`-e, --env <path>`	环境变量文件路径	`.env`
`--supabase-url <url>`	Supabase项目URL	-
`--supabase-key <key>`	Supabase项目API密钥	-
`--supabase-config <path>`	Supabase配置文件路径（JSON）	-
`--allow-anonymous`	允许匿名SSE连接（仅HTTP模式）	`false`
`--session-timeout <minutes>`	HTTP会话超时时间（分钟）	`30`
`--disable-session-cleanup`	禁用HTTP会话自动清理	`false`
`--cors-origin <origin>`	允许的CORS来源	`*`

与 Cherry Studio 集成

本服务完全支持最新的 Streamable HTTP 协议，可以与 Cherry Studio 无缝集成。

测试集成

我们提供了一个测试脚本，可以验证服务器是否正确实现了Streamable HTTP协议，并且可以与Cherry Studio集成：

# 先启动服务器
npm run start:streamable

# 在另一个终端运行测试
npm run test:cherry

# 或者使用一条命令同时启动服务器和运行测试
npm run cherry:test-with-server

在 Cherry Studio 中添加 MCP 服务

确保你的服务已在 HTTP 模式下运行
```
npm run start:streamable
```
打开 Cherry Studio 客户端 (v1.2.7 或更高版本)
点击 "MCP 服务器" 添加新服务器：
- 名称：inshow-ai-query
- 类型：Streamable HTTP
- URL：http://localhost:9000/mcp
- 如果需要，可以添加鉴权请求头
点击保存，然后在工具面板中应该可以看到可用的数据库查询工具

会话和调试

会话自动管理：服务器会生成会话ID并保持会话状态
会话自动清理：默认30分钟没有活动的会话会被自动清理
断线恢复支持：如果连接断开，Cherry Studio 可以使用相同的会话ID重新连接并继续交互
健康检查：访问 http://localhost:9000/health 可查看服务状态

技术实现

本服务基于 MCP 协议的最新规范实现，包括：

使用统一的 /mcp 端点处理所有请求
POST 请求用于初始化和发送查询
GET 请求用于建立 SSE 流接收流式响应
DELETE 请求用于终止会话
支持会话状态恢复和无状态操作
提供丰富的错误处理和调试信息

贡献

欢迎提交问题报告和请求功能。请随时提出 Pull Request。

许可证

MIT

Package detail

inshow-ai-query-mcp

readme