sqlitecloud-mcp-server | 通往MCP之路

SQLite Cloud 的模型上下文协议 (MCP) 服务器

本项目目前处于实验阶段。欢迎探索、报告问题并分享反馈。

https://github.com/user-attachments/assets/b34b2a68-ccd3-4ce6-a260-e0df6e994b79

概述

SQLite Cloud 的 MCP 服务器使您能够通过 AI 模型与 SQLite Cloud 数据库进行无缝交互。它利用模型上下文协议 (MCP) 提供了执行查询、管理架构和分析查询性能的工具。

功能

查询执行：在 SQLite Cloud 数据库上执行 SELECT、INSERT、UPDATE 和 DELETE SQL 操作。

架构管理：创建表、列出现有表并检索架构详细信息。

命令执行：运行 SQLite Cloud 支持的预定义命令。

性能分析：识别慢查询、分析查询计划并重置查询统计信息。

工具

MCP 服务器提供以下工具：

read-query：执行 SELECT 查询并获取结果。

write-query：执行 INSERT、UPDATE 或 DELETE 操作。

create-table：创建新的数据库表。

list-tables：显示数据库中的所有表。

describe-table：检索特定表的架构详细信息。

list-commands：列出可用命令并访问外部文档。

execute-command：运行来自 list-commands 工具的命令。

list-analyzer：分析慢查询，支持可选过滤器。

analyzer-plan-id：收集查询计划和索引的详细信息。

analyzer-reset：重置特定查询、组或数据库的查询统计信息。

快速开始

要使用 MCP 服务器，请先在 SQLite Cloud 上创建一个免费账户并获取您的 连接字符串。使用以下命令启动服务器：

将 <your_connection_string> 替换为您的 SQLite Cloud 连接字符串。

配置您的 AI 模型

要求

确保您的机器上已安装 Node.js，可以通过以下命令检查：

如果未安装 Node.js，您可以从 nodejs.org 下载。

VSCode 集成

请参考官方文档获取详细说明。

在项目的根目录下创建文件 .vscode/mcp.json

添加以下配置（选择您偏好的服务器配置）：

开发

构建

运行

构建完成后，使用以下命令运行：

本地测试

要在本地测试包：

打包：

运行打包后的文件：

检查

使用检查器测试 stdio 和 sse 传输。首先构建包，然后运行：

访问检查器：http://127.0.0.1:6274/

Stdio 传输

传输类型：stdio

命令：npx

参数：<PATH_TO_PACKAGE_FOLDER> --connectionString <CONNECTION_STRING>

注意：使用您主目录中的 PATH_TO_PACKAGE_FOLDER 以避免权限问题。

SSE 传输

要使用远程或本地服务器测试 sse 传输：

URL：http://localhost:8090/v1/mcp/sse