demo-mcp

Public shared memory for the Silex talk MCP + second cerveau: anyone can contribute OKF markdown notes and links (optional human summary). Same brain via web UI and MCP (read + write).

No authentication. Rate limit: 3 adds / min and 3 modifications / min per IP.

What you can share

Kind	Format	Rules
Note	Markdown + Open Knowledge Format frontmatter	type required; optional title, description, resource, tags, timestamp
Link	URL ± title ± tags ± summary	Summary is human-only (never server-generated). List needs_summary to contribute.

Notes are vectorized (when Workers AI + Vectorize are bound). Links are vectorized only if a summary is present.

Monorepo

apps/api   Hono Worker — REST + MCP + D1 + (optional) Vectorize/AI
apps/web   TanStack Router + React Query — public UI R/W
packages/shared  OKF parser/validator + Zod schemas

Quick start

bun install

# API (D1 local)
bun run dev:api
# → http://127.0.0.1:8787

# Web (proxies /api + /mcp to 8787)
bun run dev:web
# → http://127.0.0.1:5173

Apply local D1 migrations (first run / after schema change):

bun run db:migrate:local

Example: publish a note

curl -s http://127.0.0.1:8787/api/notes \
  -H 'content-type: text/markdown' \
  --data-binary @- <<'MD'
---
type: Note
title: Hello shared memory
tags: [demo, mcp]
---

Body in markdown. Link [[other]] or [x](./other.md).
MD

Example: link without summary

curl -s http://127.0.0.1:8787/api/links \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","tags":["reading"]}'

MCP

claude mcp add demo-mcp --url http://127.0.0.1:8787/mcp

POST /mcp JSON-RPC: initialize, tools/list, tools/call.

REST map

Method	Path	Bucket
GET	/api/notes, /api/notes/:id	—
POST	/api/notes (OKF MD)	add
PUT	/api/notes/:id	mod
POST	/api/notes/:id/edges	add
GET	/api/links?needs_summary=1	—
POST	/api/links	add
PATCH	/api/links/:id/summary	mod
GET	/api/search?q=	—
GET	/api/tags	—
POST	/mcp	tools write → same buckets

Production

URL: https://demo-mcp.roxabi.dev
(same origin: SPA + /api/* + POST /mcp)

Deploy (from a machine with CF Roxabi credentials in the shell — never commit .env):

# credentials via Vaultwarden / wrangler OAuth — not files in this repo
export CLOUDFLARE_ACCOUNT_ID=b5e90be971920ce406f7b679c4f1cd33

bun install
# relative API paths (empty VITE_API_URL) — no .env file
bun --filter @demo-mcp/web build
bunx wrangler d1 migrations apply demo-mcp --remote --config apps/api/wrangler.toml
bunx wrangler deploy --config apps/api/wrangler.toml

Optional embeddings: create Vectorize index, uncomment [[vectorize]] in apps/api/wrangler.toml, redeploy.

Design notes

• No auth — open write for talk/demo; IP rate limits only.
• No .env in repo — public config in wrangler.toml [vars]; CF secrets only if needed later (none today).
• OKF only for notes — invalid frontmatter → 400.
• Double surface — web curation + MCP action, one Hono API.
• Context: Silex talk MCP, plugins & second cerveau.

License

MIT