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使用哪些工具以及何时使用-您不需要管理这些工具。供参考：
| 工具 | 说明 |
|---|---|
search | 仅限Frontmatter，无文件正文。快。使用 query= 以在文件名和配置字段之间进行匹配。过滤器： tag=, status=. |
read_file | 读取单个文件的完整内容。 |
grep_vault | 在所有文件体中进行全文搜索。慢速-下载所有内容。最后的手段。 |
list_files | 仅限文件路径。不适用于上下文查找。 |
write_file | 写入或覆盖文件。 |
append_file | 附加到文件中；如果它不存在，则创建它。 |
delete_file | 删除文件。 |
move_file | 移动或重命名--用于存档已完成的笔记。 |