Turbopuffer MCP

涡轮增压器mcp

Turbopuffer MCP服务器内置 dedalus-mcp 以及DAuth风格的凭证交换。

此服务器遵循与DAuth相同的北极星模式 x-api-mcp:

• 客户端在运行时提供凭据。
• 服务器声明 Connection 随着 SecretKeys.
• 工具调用通过Dedalus安全连接句柄进行调度。

特性

• DAuth-compatible API密钥身份验证(TURBOPUFFER_API_KEY).
• 可通过以下方式配置涡轮增压器区域/基本URL TURBOPUFFER_BASE_URL.
• 核心涡轮增压器API的读写工具覆盖范围。
• 包括一个烟雾ping工具，用于快速验证MCP握手。

设置

1. 创建Turbopuffer API密钥。
2. 复制环境模板：

cp .env.example .env

必修的：

• TURBOPUFFER_API_KEY （由MCP客户端通过生产流程中的DAuth凭据提供）

可选：

• TURBOPUFFER_BASE_URL （默认为 https://gcp-us-central1.turbopuffer.com)
• DEDALUS_AS_URL （默认为 https://as.dedaluslabs.ai)
• HOST （默认为 127.0.0.1)
• PORT （默认为 8080)

跑

uv run python src/main.py

刀具表面

• turbopuffer_list_namespaces
• turbopuffer_get_namespace_metadata
• turbopuffer_get_namespace_schema
• turbopuffer_update_namespace_schema
• turbopuffer_write
• turbopuffer_query
• turbopuffer_multi_query
• turbopuffer_explain_query
• turbopuffer_delete_namespace
• turbopuffer_cache_warm
• turbopuffer_measure_recall
• turbopuffer_export_documents （已弃用Turbopuffer端点兼容性）
• smoke_ping

备注

• 涡轮增压器具有这两种功能 /v1 和 /v2 端点。此服务器镜像实时文档/API拆分：

- 命名空间列表/元数据/模式/缓存热/调用/导出使用 /v1. - 写/查询/删除/解释使用 /v2.

• 在Turbopuffer文档中，导出端点已被弃用，取而代之的是分页查询API，但为了兼容性，这里仍然公开了导出端点。