Journal Mandala MCP

这是一个用于从 Claude 直接向 Journal Mandala 写入日记条目的 MCP 服务器。

当你希望在对话过程中将“思维流”刻入曼陀罗时使用。

必要条件

• Node.js 20+

• Claude Desktop (或 Claude Code)

• Journal Mandala 的 API 密钥（获取方法请参考“获取 API 密钥”章节）

安装

使用 npm 进行全局安装。

npm install -g github:takezone/journal-mandala-mcp

更新时请重新执行相同的命令。

Claude Desktop 配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)：

单账号使用

{
  "mcpServers": {
    "journal-mandala": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

如果需要切换两个账号（个人 / 工作）

{
  "mcpServers": {
    "journal-mandala-personal": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_PERSONAL_KEY"
      }
    },
    "journal-mandala-work": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_WORK_KEY"
      }
    }
  }
}

它们在 Claude 中会显示为不同的工具。可以通过自然语言切换，例如“记录到 work”。

配置完成后请重启 Claude Desktop。

获取 API 密钥

目前请将以下信息告知 Journal Mandala 管理员（@takezone）以获取密钥：

1. 你的 Google 账号邮箱地址

2. 标签名称（例如：alice-personal）

收到管理员发送的 API 密钥后，将其复制粘贴到上述配置的 JOURNAL_MANDALA_API_KEY 中。

注意： 未来计划支持在浏览器中自动生成。

使用方法

在与 Claude 的对话中，请求“将今天的事件记录到日记中”等，add_journal_entry 工具就会被调用，并将条目添加到 Journal Mandala。

可记录的项目：

• title 标题（可选）

• event 事件（发生了什么）

• thought 思考（感受如何）

• entry_date 日期 YYYY-MM-DD（省略时默认为 JST 今天）

• entry_time 时间 HH:MM

• tags 标签数组

• star_rating 1-5 星评分

title / event / thought 中至少需要包含一项。

可选环境变量

• JOURNAL_MANDALA_API_URL — API 端点（默认：https://journal-mandala.vercel.app）

故障排除

• Claude 中不显示工具 → 可能是配置文件 JSON 语法错误。请在 Claude Desktop 的开发者菜单中查看 MCP 日志

• API 错误 401 → JOURNAL_MANDALA_API_KEY 无效。请联系管理员重新发放

• 网络错误 → 请检查 Vercel 的运行状态

许可证

MIT