Sutra

Name: Sutra
Author: shivnathtathe

远程服务

sutra.shivnathtathe.com记忆与知识18 周前更新

代码仓库访问官网

关于 Sutra

Sutra 是面向 AI Agent 的托管式私人记忆与技能服务，可将可移植上下文连接到现有客户端。它区分项目上下文，并要求用户明确授权写入、上传和导出。

主要功能

01读取与搜索记忆
02按项目集群隔离上下文
03管理可复用技能
04用户授权后写入与导出
05支持 OAuth 与专用 API 密钥

适用场景

01在不同 Agent 间共享项目上下文
02检索已保存的偏好和事实
03向 Agent 提供已启用的技能
04导出个人记忆以便迁移

MCP 相关

Sutra 提供远程 MCP 服务，向客户端开放 10 个类型化工具，用于读取上下文、管理记忆和技能。连接可使用 OAuth 2.1 或专用 API 密钥。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://sutra-c3or.onrender.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http shivnathtathe-sutra https://sutra-c3or.onrender.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"shivnathtathe-sutra":{"type":"http","url":"https://sutra-c3or.onrender.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"shivnathtathe-sutra":{"type":"http","url":"https://sutra-c3or.onrender.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"shivnathtathe-sutra":{"type":"http","url":"https://sutra-c3or.onrender.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"shivnathtathe-sutra":{"serverUrl":"https://sutra-c3or.onrender.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

用于连接托管版 Sutra 服务的开源 MCP 集成文件。
将私有、可移植的上下文连接到你已在使用的 AI Agent。

网站 · 所有集成 · Smithery · Glama · 支持

连接 Sutra

https://sutra-c3or.onrender.com/mcp

连接方式	适用情况	工作方式
OAuth 2.1	客户端支持远程 MCP 授权。	客户端会在浏览器中打开 Sutra，请求授权，并保存授权凭据。
API key	客户端需要 `Authorization` 标头。	你可以在 Sutra 中创建专用、可撤销的密钥，并通过客户端的密钥管理机制保存。

创建 Sutra 账户。
选择下方的客户端配置。
按提示完成 OAuth 授权或输入专用 API key。
确认客户端已发现 10 个工具。
试试：Use Sutra to list my project clusters. Ask before saving anything.

重要

切勿将真实的 Sutra API key、OAuth 令牌、记忆导出文件或密码放入已提交到版本库的配置文件中。

选择客户端

客户端	身份验证	配置
Cursor	OAuth	`clients/cursor-mcp.json`
OpenCode	OAuth with DCR and PKCE	`clients/opencode.json`
VS Code / GitHub Copilot	可撤销的 API 密钥	`clients/vscode-mcp.json`
Claude Code	可撤销的 API 密钥	引导式 CLI 设置

Cursor OAuth

将此仓库安装为 Agent 插件，或将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "sutra": {
      "url": "https://sutra-c3or.onrender.com/mcp"
    }
  }
}

连接服务并完成 Sutra 的浏览器授权流程。

OpenCode OAuth + DCR + PKCE

将 clients/opencode.json 合并到全局或项目的 opencode.json 中：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sutra": {
      "type": "remote",
      "url": "https://sutra-c3or.onrender.com/mcp",
      "oauth": {}
    }
  }
}

完成授权并检查连接：

opencode mcp auth sutra
opencode mcp list

VS Code and GitHub Copilot API key

将 clients/vscode-mcp.json 复制到 .vscode/mcp.json，或将其合并到用户 MCP 配置中：

{
  "inputs": [
    {
      "id": "sutra-api-key",
      "type": "promptString",
      "description": "Sutra API key",
      "password": true
    }
  ],
  "servers": {
    "sutra": {
      "type": "http",
      "url": "https://sutra-c3or.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sutra-api-key}"
      }
    }
  }
}

从 MCP 配置编辑器启动 Sutra。VS Code 会通过掩码输入框请求密钥，而不会将其存储在文件中。

Claude Code API key

使用 Sutra CLI 进行引导式设置：

npm install -g @shivnathtathe/sutra-cli
sutra connect claude-code

CLI 会请求专用密钥，并安全地写入受支持的本地配置。它不会将你的密钥发送到此仓库。

需要其他 Agent？Sutra 提供了全部 22 个经过测试的集成的最新说明。

已确认的兼容性

_{11 个 Web Agent 使用 OAuth。11 个 CLI 和桌面 Agent 使用专用 API 密钥。产品名称和标志归各自所有者所有。}

工具概览

Sutra 提供 10 个类型化工具。读取操作只会检索当前请求所需的上下文。写入、上传和导出操作需要用户明确授权。

上下文与记忆	访问权限	用途
`read_context`	读取	加载用户共享的身份上下文。
`search_memory`	读取	按关键词查找特定记忆。
`list_clusters`	读取	查找可用的项目集群。
`get_cluster`	读取	加载一个已知的项目集群。
`write_observation`	写入	保存一条持久偏好、决策、更正或事实。
`export_all`	导出	导出用户的所有记忆，以便数据迁移。

可复用技能	访问权限	用途
`list_skills`	读取	查找用户明确启用的技能。
`get_skill`	读取	加载已启用的技能及其资源索引。
`get_skill_resource`	读取	读取已启用技能引用的一项资源。
`upload_skill`	写入	经明确授权后上传新版本的不可变技能。

数据边界

Sutra 会	Sutra 不会
存储用户或授权 Agent 明确保存的观察内容。	复制连接的客户端中的每段对话。
将无关上下文隔离在命名的项目集群中。	自动让每个请求共用一个集群。
显示已存储记忆的来源 Agent、标签和活动记录。	将写入操作隐藏在不透明的客户端配置文件中。
支持可撤销的 OAuth 授权和按客户端设置的 API 密钥。	要求所有 Agent 共用一个永久凭证。
提供明确的完整导出功能，便于迁移。	将用户记忆锁定在某个 AI 厂商的平台上。

在连接敏感工作流之前，请阅读安全性和数据边界、隐私政策和服务条款。

仓库内容

.
|-- plugin.json             # Agent Plugins 1.0 manifest
|-- mcp.json                # Portable Streamable HTTP connection
|-- server.json             # Official MCP Registry metadata
|-- clients/
|   |-- cursor-mcp.json
|   |-- opencode.json
|   `-- vscode-mcp.json
|-- docs/
|   |-- client-support.md
|   `-- security-and-data.md
`-- assets/
    |-- integration-grid.svg
    |-- readme-hero.png       # Pixel-tested GitHub banner
    |-- readme-hero.svg       # Editable banner source
    `-- sutra-logo.png