v0.2.0

MCP Server for AI Integration

Ocean Brain now includes a built-in MCP (Model Context Protocol) server, allowing AI tools like Claude Code to search and read your notes directly.

New Features

• MCP Server — 4 read-only tools for AI integration:
  • search_notes — Search notes by keyword
  • read_note — Read note content (with smart truncation)
  • list_tags — List all tags with note counts
  • list_recent_notes — List recently updated notes
• contentAsMarkdown GraphQL field — Server-side BlockNote → Markdown conversion using @blocknote/server-util
• CLI subcommand — ocean-brain mcp --server <url> (supports local and remote servers)

Bug Fixes

• Fix npx ocean-brain serve failing due to prisma binary not found in hoisted node_modules

Setup

Add to your Claude Code MCP config (.mcp.json):

{
  "mcpServers": {
    "ocean-brain": {
      "command": "npx",
      "args": ["-y", "ocean-brain", "mcp", "--server", "http://localhost:6683"]
    }
  }
}

Example

❯ What are my recent notes about?

⏺ ocean-brain - list_recent_notes (MCP)(limit: 5)
  ⎿  {
       "totalCount": 735,
       "notes": [
         { "id": "495", "title": "Weekly Plan - Jan Week 2", "tags": ["@todo", "@work"] },
         { "id": "411", "title": "Weekly Plan - Nov Week 5", "tags": ["@todo", "@work"] },
         ...
       ]
     }

⏺ ocean-brain - read_note (MCP)(id: "495", maxLength: 1000)
  ⎿  # Weekly Plan - Jan Week 2

     Tags: @todo, @work, @personal, @retrospective

     ### Weekly Goals
     * Sign up for guitar lessons
     * Sign up for baking classes
     ...