zhengchen.tao
28f9a54ba9
把 Obsidian vault 通过 MCP 暴露给 Claude.ai，OAuth 走 nas-auth。 设计文档见 vault Coding/obsidian-mcp/obsidian-mcp 设计.md。 代码层落地参考 vault Coding/obsidian-mcp/MCP 实现指南.md。 V1+V2 同时实现（用户要求跳过分阶段直接全部）： 读 Tools（需 scope=read:obsidian）： - list_vault_tree（一次性 vault 地图，限制深度） - list_files / read_file（含 offset/limit 大文件分页） - search（子串匹配 + glob 过滤，最多 50 hits） - get_metadata（size / modified_at / has_frontmatter） 写 Tools（需 scope=write:obsidian）： - write_file / append_file - 多重门禁：scope 校验 + 路径黑名单 + 写入白名单 + 永禁文件 - 永禁写：任意目录的 AGENTS.md / PROFILE.md / README.md / CLAUDE.md / 01-Secret/** - 白名单：02-ShengquGames/logs/ + Coding/ + NAS/NAS 待办清单.md - 写入审计日志按天 rotate（JSON line） 安全： - VaultPathResolver chroot：path traversal + symlink 双拒绝 - JwtBearer (HS256, Current+Previous fallback, MapInboundClaims=false) - aud=obsidian, iss=https://auth.zhengchentao.win - 黑名单：01-Secret / .obsidian / .trash / .git 技术栈： - .NET 10 + ModelContextProtocol SDK 1.0 - Streamable HTTP transport (POST /mcp) - JwtBearer 10.0 + IdentityModel.Tokens 8.x 部署： - Dockerfile multi-stage，runtime 装 ripgrep（V3 备用），non-root user - .gitea/workflows/build-image.yml：build + deploy 双 job，buildkit v0.13.2 - 容器内 :8080，宿主端口 9090 - 子域名 obs.zhengchentao.win - vault 挂载 /volume1/docker/webdav/data/Zhengchen:/vault:rw（V2 写入需要 rw） 测试：35/35 单测过（VaultPathResolver path traversal/blacklist/symlink + VaultWriteGuard whitelist/forbidden） Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
42 lines
1.0 KiB
JSON
42 lines
1.0 KiB
JSON
{
|
|
// 生产配置：所有敏感值通过环境变量注入，这里只放非敏感的生产默认值。
|
|
//
|
|
// 必须通过 env 覆盖的项：
|
|
// Jwt__SigningKey__Current=<与 nas-auth 共享的 HS256 密钥>
|
|
// Jwt__SigningKey__Previous=<密钥轮换时的旧密钥，可选>
|
|
// Vault__Root=/vault
|
|
//
|
|
// 可选覆盖：
|
|
// Vault__Blacklist__0=<额外黑名单段>
|
|
// Vault__WriteWhitelist__0=<额外写入白名单前缀>
|
|
|
|
"Logging": {
|
|
"LogLevel": {
|
|
"Default": "Warning",
|
|
"Microsoft.AspNetCore": "Warning"
|
|
}
|
|
},
|
|
|
|
"Vault": {
|
|
"Root": "/vault"
|
|
},
|
|
|
|
"Jwt": {
|
|
"Issuer": "https://auth.zhengchentao.win",
|
|
"Audience": "obsidian"
|
|
},
|
|
|
|
"Mcp": {
|
|
"OAuthDiscovery": {
|
|
"Issuer": "https://auth.zhengchentao.win",
|
|
"AuthorizationEndpoint": "https://auth.zhengchentao.win/authorize",
|
|
"TokenEndpoint": "https://auth.zhengchentao.win/token",
|
|
"RegistrationEndpoint": "https://auth.zhengchentao.win/register"
|
|
}
|
|
},
|
|
|
|
"AuditLog": {
|
|
"Directory": "/app/logs"
|
|
}
|
|
}
|