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
在保留所有已有字节的情况下追加内容。