mcp-turso-cloud
2025.04.18
2
TypeScript数据库管理Turso 集成数据库
mcp-turso-cloud 是一个基于 Model Context Protocol (MCP) 的服务，专门用于与 Turso 数据库集成，为大型语言模型（LLMs）提供数据库管理功能。该服务实现了两级认证系统，支持组织级别和数据库级别的操作，使得 LLMs 能够直接管理和查询 Turso 数据库。
View on GitHub
Overview
基本能力
产品定位
mcp-turso-cloud 是一个专为 LLMs 设计的数据库管理服务，通过 MCP 协议提供与 Turso 数据库的无缝集成，支持组织级别和数据库级别的操作。
核心功能
- 组织级别操作
- 列出组织中的所有数据库
- 创建新数据库
- 删除数据库
-
生成数据库令牌
-
数据库级别操作
- 列出数据库中的所有表
- 执行 SQL 查询
- 获取表结构信息
-
向量相似性搜索
-
两级认证系统
- 组织级别认证（Turso Platform API token）
- 数据库级别认证（数据库特定令牌）
适用场景
- LLMs 需要直接访问和管理 Turso 数据库
- 需要执行复杂的 SQL 查询或向量搜索
- 自动化数据库管理任务
工具列表
- Organization Tools
list_databases: 列出组织中的所有数据库create_database: 创建新数据库delete_database: 删除数据库-
generate_database_token: 生成数据库令牌 -
Database Tools
list_tables: 列出数据库中的所有表execute_query: 执行 SQL 查询describe_table: 获取表结构信息vector_search: 执行向量相似性搜索
常见问题解答
- API Token Issues
- 验证 Turso API token 是否有效且有足够权限
- 检查组织名称是否正确
-
确保 token 未过期
-
Database Connection Issues
- 验证数据库是否存在于组织中
- 检查 API token 是否有访问权限
- 确保数据库名称拼写正确
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
- 确保已获取有效的 Turso Platform API token
安装教程
- 克隆仓库
- 安装依赖
npm install
- 构建项目
npm run build
- 运行开发模式
npm run dev
调试方式
- 运行开发模式后，检查控制台输出是否有错误
- 使用提供的 API 工具进行测试
- 验证环境变量是否正确设置
开发与发布
发布步骤
- 更新 package.json 中的版本号
- 构建项目
npm run build
- 发布到 npm
npm publish