AI导哈

Turbopuffer MCP服务器

一个基于dedalus-mcp和DAuth式凭证交换构建的Turbopuffer MCP服务器，提供核心Turbopuffer API的读写工具覆盖，支持DAuth兼容的API密钥认证。

  • by dedalus-labs
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dedalus-labs/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，但为了兼容性，这里仍然公开了导出端点。

相关 MCP