palace-mcp

MCP 服务器，通过 Local REST API 插件将 Obsidian 仓库暴露给 AI 助手。

基于 FastMCP 构建。代理可以列出、读取、写入、搜索和删除笔记，并读取当前在 Obsidian 中打开的任意笔记。

先决条件

• 安装了 Local REST API 插件并正在运行的 Obsidian

• Python 3.12+

• uv（推荐）或 pip

继续之前，请先从 Obsidian 的插件设置中复制你的 API 密钥。

Related MCP server: obsidian-local-mcp

安装

git clone <repo-url> palace-mcp
cd palace-mcp
uv sync

配置

当通过 HTTPS 使用插件的自签名证书时，会自动跳过证书验证。

运行

通过 stdio 启动服务器（MCP 客户端的默认传输方式）：

export OBSIDIAN_API_KEY="your-api-key"
uv run python server.py

或者通过 FastMCP：

uv run fastmcp run server.py

Cursor 配置

添加到你的 MCP 配置中（例如 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "obsidian-palace": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/palace-mcp",
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

保存后重启 Cursor 或重新加载 MCP 服务器。

工具

追加保护

某些仓库路径被视为 仅覆盖。向这些路径追加内容可能会在单个笔记中静默地堆叠重复内容，日后很难察觉。

默认情况下，append_note 会拒绝匹配以下路径的请求：

• /Context/（Context 文件夹下的任何笔记）

• /System/（System 文件夹下的任何笔记）

• Index.md（任何名为 Index.md 的文件）

请改用 write_note 替换这些笔记。可通过 PALACE_APPEND_DENY 环境变量覆盖拒绝列表。

许可证

MIT