MCP · Diarum

内置 Model Context Protocol 服务（Streamable HTTP），Claude、Cursor 等 AI 客户端通过 API 令牌只读访问你的日记。

什么是 MCP

Model Context Protocol（MCP）是让 AI 应用连接外部数据源的开放协议。Diarum 内置了一个 MCP 服务端，开启后，支持 MCP 的 AI 客户端（Claude Desktop、Claude Code、Cursor、Cherry Studio、VS Code 等）就可以直接查询你的日记，帮你回顾、总结、规划。

开启方式

打开「设置 → API 访问」，开启 API，获得你的 API 令牌；
在同一页面开启 MCP 服务（独立开关，可以只开 API 不开 MCP）；
复制页面上生成的客户端配置，粘贴到你的 AI 客户端。

客户端配置

接口地址为 https://你的域名/api/v1/mcp，使用 Streamable HTTP 传输，通过 Authorization: Bearer <令牌> 认证：

{
  "mcpServers": {
    "diarum": {
      "type": "http",
      "url": "https://diary.example.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

以 Claude Code 为例，也可以一条命令添加：

claude mcp add --transport http diarum https://diary.example.com/api/v1/mcp \
  --header "Authorization: Bearer <your-api-token>"

提供的工具

所有工具都是只读的，权限范围与 API 令牌一致：只能读取令牌所属用户自己的日记。

工具	参数	作用
`get_diary`	`date`	获取某一天的日记，返回正文、心情和天气
`list_diaries`	`start`、`end`、`limit`	列出日期范围内的日记（新的在前，默认 50 篇，最多 200）
`search_diaries`	`query`、`limit`	对日记内容进行全文搜索

安全可控

MCP 有独立开关，随时关闭；重置 API 令牌后旧令牌立即失效；
每一次 MCP 调用都会写入审计日志，读取日记还会记录到访客统计中，你可以清楚地看到 AI 读了哪几天的日记；
只读设计，AI 无法修改或删除你的任何内容。

可以这样用

“读一下我上周的日记，帮我整理成周报。”
“搜索我所有提到‘跑步’的日记，总结一下我的运动习惯。”
“看看我去年 10 月在忙什么。”