2 v0.1.0 更新于 2026-10-24
Obsidian GitHub MCP MCP Server
A permissioned MCP gateway for agent proposals to a Git-backed Obsidian vault.
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(npm)
{
"mcpServers": {
"obsidian-github-mcp": {
"command": "npx",
"args": [
"-y",
"@sarutobi-sasuke/obsidian-github-mcp"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 8 个工具
vault_whoami
显示当前认证身份、broker、分支和策略作用域。
vault_list_allowed_paths
说明有效的读/写/拒绝路径边界。
vault_explain_access
对单个路径进行 dry run,判断读、列或写是否被允许及由哪条策略决定,不调用 GitHub。
vault_list_files
列出已授权目录并过滤被拒绝的子项。
vault_read_file
读取已授权的 UTF-8 vault 文件。
vault_create_file
在该身份的固定提案分支上创建文件。
vault_update_file
在遵守可变性规则的前提下更新允许的文件。
vault_append_file
在保留所有已有字节的情况下追加内容。