Clavis

io.github.KN0WBOT由 GitHub 账号 KN0WBOT 发布v0.1.3更新于 Oct 24, 2026

Encrypted credential vault for AI agents — auto OAuth refresh, rate limiting, audit logging.

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

Clavis 是一个本地 MCP 服务器，让助手访问加密凭据保险库，并通过服务端注入的密钥调用外部服务。

可以做什么
列出已存储凭据的服务，并查看各凭据的状态与过期时间。通过保险库发起上游 API 调用，密钥在服务端注入，不会进入对话。使用旧版工具获取指定服务的原始访问令牌或 API 密钥。由 Clavis 服务器负责 OAuth 令牌自动刷新、速率限制、审计日志与用量统计。
适用场景
当助手需要用已存储的凭据调用第三方 API，且希望密钥不进入对话上下文时使用。也适合希望对这类调用集中进行 OAuth 刷新、速率限制和审计记录的场景。
运行要求
通过 npm 包以 stdio 在本地运行，通常用 npx 启动或全局安装，因此需要 Node.js。需要 Clavis 账户，并通过环境变量 CLAVIS_API_KEY 提供从登录接口获取的 Clavis JWT，而不是注册时显示的密钥。自托管实例可设置 CLAVIS_API_URL；需要能访问 Clavis 服务器的网络。
安装前请注意
配置要求在 CLAVIS_API_KEY 中提供 Clavis JWT，该令牌可访问已存储的凭据。旧版 get_credentials 工具会把原始密钥返回到对话中，提示注入可能将其窃取，应优先使用 call_service。经保险库发起的调用会到达第三方服务，并由 Clavis 服务器记录和限流，请确认向上游发送的数据内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Clavis，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Clavis MCP Server

Secure credential management for Claude Desktop and MCP servers.

Features

  • 🔐 Encrypted credential storage (AES-128-CBC + HMAC-SHA256, via Fernet)
  • 🛡️ Server-side credential injection — the raw key never enters the conversation
  • 🔄 Automatic OAuth token refresh
  • 📡 Thin forwarding layer — rate limiting, audit logging, and usage tracking are all handled by the Clavis server

Installation

bash
npx @clavisagent/mcp-server

Or install globally:

bash
npm install -g @clavisagent/mcp-server

Usage with Claude Desktop

Add the following to your Claude Desktop configuration file (claude_desktop_config.json):

json
{  "mcpServers": {    "clavis": {      "command": "npx",      "args": ["-y", "@clavisagent/mcp-server"],      "env": {        "CLAVIS_API_KEY": "eyJ..."      }    }  }}

Usage with Claude Code

bash
claude mcp add clavis -- npx -y @clavisagent/mcp-server

Configuration

VariableRequiredDefaultDescription
CLAVIS_API_KEYyes—Your Clavis JWT, from POST /v1/auth/login. Not the cla_… key shown at sign-up.
CLAVIS_API_URLnohttps://clavisagent.comBase URL of your Clavis instance. Set this for self-hosted deployments.

Available Tools

ToolDescription
call_serviceRecommended. Make an API call with server-side credential injection — the credential is injected into the upstream request server-side, so the raw key never enters the conversation.
get_credentialsLegacy. Returns the raw access token or API key for a named service. Prefer call_service.
list_servicesList all services with stored credentials
check_credential_statusCheck the status and expiry of credentials for a service

Security note

Prefer call_service over get_credentials. call_service keeps the secret server-side, so a prompt injection has no credential in context to exfiltrate. get_credentials places the raw key in the conversation and exists only for callers that must hold the token themselves.

License

MIT

来源：README.md，提交 92ecdc1

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分