mcp-turso-云

模型上下文协议 (MCP) 服务器，为 LLM 提供与 Turso 数据库的集成。该服务器实现了两级身份验证系统，可同时处理组织级和数据库级操作，从而可以轻松地直接从 LLM 管理和查询 Turso 数据库。

特征

🏢 组织级运营

列出数据库：查看 Turso 组织中的所有数据库
创建数据库：使用可自定义的选项创建新的数据库
删除数据库：从您的组织中删除数据库
生成数据库令牌：为特定数据库创建身份验证令牌

💾 数据库级操作

列出表：查看特定数据库中的所有表
执行查询：对数据库运行 SQL 查询
描述表：获取数据库表的架构信息
向量搜索：使用 SQLite 向量扩展执行向量相似性搜索

两级认证系统

服务器实现了复杂的身份验证系统：

组织级身份验证
- 使用 Turso 平台 API 令牌
- 管理数据库和组织级操作
- 通过 Turso 仪表板获取
数据库级身份验证
- 使用数据库特定的令牌
- 使用组织令牌自动生成
- 缓存以提高性能并根据需要轮换

配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境下的示例：

Cline/Claude 桌面配置

将其添加到您的 Cline/Claude Desktop MCP 设置中：

{
	"mcpServers": {
		"mcp-turso-cloud": {
			"command": "npx",
			"args": ["-y", "mcp-turso-cloud"],
			"env": {
				"TURSO_API_TOKEN": "your-turso-api-token",
				"TURSO_ORGANIZATION": "your-organization-name",
				"TURSO_DEFAULT_DATABASE": "optional-default-database"
			}
		}
	}
}

带有 WSL 配置的 Claude 桌面

对于 WSL 环境，将其添加到您的 Claude Desktop 配置中：

{
	"mcpServers": {
		"mcp-turso-cloud": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"TURSO_API_TOKEN=your-token TURSO_ORGANIZATION=your-org node /path/to/mcp-turso-cloud/dist/index.js"
			]
		}
	}
}

环境变量

服务器需要以下环境变量：

TURSO_API_TOKEN ：您的 Turso 平台 API 令牌（必需）
TURSO_ORGANIZATION ：您的 Turso 组织名称（必填）
TURSO_DEFAULT_DATABASE ：未指定时使用的默认数据库（可选）
TOKEN_EXPIRATION ：生成的数据库令牌的到期时间（可选，默认值：'7d'）
TOKEN_PERMISSION ：生成令牌的权限级别（可选，默认值：“完全访问”）

API

服务器实现按类别组织的 MCP 工具：

组织工具

列出数据库

列出 Turso 组织中的所有数据库。

参数：无

响应示例：

{
	"databases": [
		{
			"name": "customer_db",
			"id": "abc123",
			"region": "us-east",
			"created_at": "2023-01-15T12:00:00Z"
		},
		{
			"name": "product_db",
			"id": "def456",
			"region": "eu-west",
			"created_at": "2023-02-20T15:30:00Z"
		}
	]
}

创建数据库

在您的组织中创建一个新的数据库。

参数：

name （字符串，必需）：新数据库的名称
group （字符串，可选）：将数据库分配到的组
regions （string[]，可选）：部署数据库的区域

例子：

{
	"name": "analytics_db",
	"group": "production",
	"regions": ["us-east", "eu-west"]
}

删除数据库

从您的组织中删除数据库。

参数：

name （字符串，必需）：要删除的数据库的名称

例子：

{
	"name": "test_db"
}

生成数据库令牌

为特定数据库生成新令牌。

参数：

database （字符串，必需）：数据库名称
expiration （字符串，可选）：令牌到期时间
permission （字符串，可选）：权限级别（“完全访问”或“只读”）

例子：

{
	"database": "customer_db",
	"expiration": "30d",
	"permission": "read-only"
}

数据库工具

列表表

列出数据库中的所有表。

参数：

database （字符串，可选）：数据库名称（如果未提供，则使用上下文）

例子：

{
	"database": "customer_db"
}

执行查询

对数据库执行 SQL 查询。

参数：

query （字符串，必需）：要执行的 SQL 查询
params （对象，可选）：查询参数
database （字符串，可选）：数据库名称（如果未提供，则使用上下文）

例子：

{
	"query": "SELECT * FROM users WHERE age > ?",
	"params": { "1": 21 },
	"database": "customer_db"
}

描述表

获取表的架构信息。

参数：

table （字符串，必需）：表名称
database （字符串，可选）：数据库名称（如果未提供，则使用上下文）

例子：

{
	"table": "users",
	"database": "customer_db"
}

向量搜索

使用 SQLite 矢量扩展执行矢量相似性搜索。

参数：

table （字符串，必需）：表名称
vector_column （字符串，必需）：包含矢量的列
query_vector (number[]，必需)：用于相似性搜索的查询向量
limit （数字，可选）：最大结果数（默认值：10）
database （字符串，可选）：数据库名称（如果未提供，则使用上下文）

例子：

{
	"table": "embeddings",
	"vector_column": "embedding",
	"query_vector": [0.1, 0.2, 0.3, 0.4],
	"limit": 5,
	"database": "vector_db"
}

发展

设置

克隆存储库
安装依赖项：

npm install

构建项目：

npm run build

以开发模式运行：

npm run dev

出版

更新 package.json 中的版本
构建项目：

npm run build

发布到 npm：

npm publish

故障排除

API 令牌问题

如果遇到身份验证错误：

验证您的 Turso API 令牌是否有效并具有必要的权限
检查您的组织名称是否正确
确保您的令牌尚未过期

数据库连接问题

如果您在连接数据库时遇到问题：

验证数据库是否存在于您的组织中
检查你的 API 令牌是否可以访问数据库
确保数据库名称拼写正确

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

致谢

构建于：

mcp-turso-cloud

Integrations