S3 Vault MCP

s3保险库mcp

给予 克劳德代码 对存储在S3中的markdown笔记库进行读/写访问。Claude可以直接从S3存储桶中搜索笔记的上下文，阅读笔记并编写新笔记，而无需任何中间应用程序。

运作原理

Claude Code支持MCP（模型上下文协议），这是将Claude连接到外部工具和数据源的标准。此服务器为S3支持的markdown保管库实现了该协议。它作为Docker容器运行；Claude Code在需要时自动启动它，并通过stdio进行通信。

需求

• 码头工人
• 克劳德代码 命令行界面

设置

运行一次此命令，使用Claude Code注册服务器。用S3凭据替换占位符值。

claude mcp add vault \
  -s user \
  -e S3_ENDPOINT=https://your-s3.example.com \
  -e S3_ACCESS_KEY=yourkey \
  -e S3_SECRET_KEY=yoursecret \
  -e S3_BUCKET=your-bucket \
  -e S3_SEARCH_FIELDS=title,tags,path \
  -- docker run -i --rm \
    -e S3_ENDPOINT -e S3_ACCESS_KEY -e S3_SECRET_KEY -e S3_BUCKET -e S3_SEARCH_FIELDS \
    ghcr.io/gronare/s3-vault-mcp:latest

这 -s user flag在所有项目中为您的用户帐户注册服务器。Docker在第一次运行时自动拉取映像。

验证： 重新启动Claude Code并运行 /mcp — vault 应显示绿色连接状态。

为您的保管库进行配置

S3_SEARCH_FIELDS

控制哪些 前言 字段 search 工具与使用时匹配 query=。设置此项以匹配您在笔记中使用的属性名称。

# If your notes have: title, tags, and a path property
-e S3_SEARCH_FIELDS=title,tags,path

# If your notes use different property names
-e S3_SEARCH_FIELDS=title,topics,area

无论此设置如何，文件名始终匹配。

CLAUDE.md

CLAUDE.md 是Claude Code在每个会话开始时读取的纯文本文件。它允许您定义Claude应该一致遵循的约定——文件夹结构、注释格式、工作流规则。

服务器已向发送Claude指令 *如何使用这些工具* （工具成本、何时搜索与何时阅读等）。 CLAUDE.md 是你定义的地方 *在保险库里放什么* --你的结构和惯例。

创建或编辑 ~/.claude/CLAUDE.md （适用于所有项目）并添加：

## Vault

The `vault` MCP connects to my notes in S3. Search it at the start of every
session before doing any work.

## Note structure

- `Projects/`  — active work with a defined goal
- `Areas/`     — ongoing topics (work, homelab, etc.)
- `Resources/` — reference notes, how-tos, snippets
- `Archive/`   — completed notes; move here, never delete

Frontmatter: title, date (YYYY-MM-DD), tags, status (draft/active/complete),
path (the filesystem path this note relates to).

调整以匹配您的实际结构。集 S3_SEARCH_FIELDS 与您在此处列出的frontmatter字段名称相同。

工具

服务器告诉Claude使用哪些工具以及何时使用-您不需要管理这些工具。供参考：