用途
obsidian-codex-mcp 是一个本地优先的 MCP 服务器，用于让 MCP 客户端直接操作 Obsidian 知识库中的 Markdown 文件。它不依赖 Obsidian 插件、API 密钥或云端服务，也不需要 Obsidian 程序在后台运行，所有操作直接作用于本地文件系统。
主要能力
- 笔记操作：读取单个笔记（get_note）、创建笔记（create_note）、更新内容或 frontmatter（update_note）、删除笔记（delete_note）、列出笔记（list_notes）、搜索标题/内容/标签（search_notes）。
- 元数据与链接：获取所有标签（get_all_tags）、查找反向链接（get_backlinks）、提取 wikilink（get_note_links）。
- 文件夹管理：创建文件夹（create_folder）、获取文件夹树（get_folder_structure）、配置知识库路径（configure_vault）。
- Bases 支持：创建（create_base）、更新（update_base）、读取（get_base）、列出（list_bases）、删除（delete_base） .base 文件，所有写入均依据官方 Bases schema 校验，支持 table、list、cards、map 四种视图，且 Maps 社区插件的 marker/zoom 设置在读写往返中保留。
- 自动化脚本：可生成每日项目状态报告并写回 Obsidian，报告包含最近笔记、Markdown 复选框任务和热门标签。
使用方式
环境要求：Python 3.10 或更高版本；Obsidian 知识库以本地 Markdown 文件存储。 安装：运行 install.sh 会创建本地虚拟环境、安装依赖、验证知识库，并输出对应客户端的即用配置（--client claude|claude-desktop|codex|cursor|cline|grok，默认 all）。手动步骤包括：配置 MCP 客户端，将客户端指向虚拟环境的 Python 和 server.py，通过环境变量设置知识库路径，然后重启或重新连接客户端。 配置示例：Claude Desktop / Cursor / Cline 使用 mcpServers 配置块；Codex / Grok 使用 ~/.codex/config.toml 或 ~/.grok/config.toml。 安全选项：OBSIDIAN_READ_ONLY=true 可启用只读模式（同时阻止 create_base、update_base、delete_base）；OBSIDIAN_BACKUP_ON_WRITE=true 可在更新/删除前将现有笔记和 .base 文件复制到 .obsidian-mcp-backups/。 路径规则：所有笔记路径相对于 OBSIDIAN_VAULT_PATH 解析，拒绝绝对路径和 ../ 路径遍历；delete_note 仅删除 .md，delete_base 仅删除 .base；两类工具路径不交叉；服务器不进行外部网络调用；frontmatter YAML 损坏不影响列表/搜索，笔记仍可读但元数据为空。
适用场景
- 使用 MCP 客户端且希望对 Obsidian 知识库进行安全本地访问的用户。
- 偏好基于文件系统的 Obsidian 自动化，而非 Local REST API 插件的开发者。
- 希望通过代理创建和编辑 Obsidian Bases（.base）的用户。
- 个人知识库、项目日志、每日笔记、任务笔记和 Markdown 优先的工作流。
限制
- 搜索为简单子字符串搜索，非语义或索引搜索。
- 无法访问 Obsidian 命令面板或插件 API。
- 不处理同时编辑的冲突解决。
- 不支持模板扩展。
- 不具备同步服务感知能力。
