@gilangjavier/chrona 0.1.0 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 Local-first, deterministic, time-aware memory for agents.
 
-`chrona` is a TypeScript library and CLI for storing durable memories with provenance, privacy scopes, confidence scores, TTL support, and deterministic retrieval. It is designed for local use first: the default storage layer is SQLite, the output is stable, and the CLI can emit clean JSON for pipelines and agent runtimes.
+`chrona` is a TypeScript library, CLI, and MCP server for storing durable memories with provenance, privacy scopes, confidence scores, TTL support, and deterministic retrieval. It is designed for local use first: the default storage layer is SQLite, the output is stable, and both the CLI and MCP tools emit clean JSON-friendly shapes for pipelines and agent runtimes.
 
 - Repo: https://github.com/gilangjavier/chrona
 - npm: https://www.npmjs.com/package/@gilangjavier/chrona
@@ -18,6 +18,7 @@ Most agent memory tooling either stays too loose to trust in automation or too h
 - privacy-aware scopes for user, project, org, and shared memory
 - time-aware entries with `createdAt` and optional `expiresAt`
 - both CLI and library usage for scripts, services, and local tools
+- drop-in MCP server mode for agent integrations
 
 ## Data model
 
@@ -167,6 +168,64 @@ chrona --db ./.chrona/agent.db timeline \
   --json
 ```
 
+#### MCP Server
+
+Run Chrona as an MCP server over stdio:
+
+```bash
+chrona mcp --db ./.chrona/agent.db
+```
+
+Run it over Streamable HTTP on a local port:
+
+```bash
+chrona mcp --db ./.chrona/agent.db --port 3030
+```
+
+Chrona exposes these MCP tools:
+
+- `chrona_add`
+- `chrona_get`
+- `chrona_search`
+- `chrona_timeline`
+- `chrona_export`
+- `chrona_import`
+- `chrona_gc`
+
+Copy-paste stdio config:
+
+```json
+{
+  "mcpServers": {
+    "chrona": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@gilangjavier/chrona",
+        "mcp",
+        "--db",
+        "/absolute/path/to/chrona.db"
+      ]
+    }
+  }
+}
+```
+
+Copy-paste Streamable HTTP config:
+
+```json
+{
+  "mcpServers": {
+    "chrona": {
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://127.0.0.1:3030/mcp"
+      }
+    }
+  }
+}
+```
+
 ### B) For humans
 
 Install locally in a project:
@@ -356,6 +415,24 @@ Deterministic run with a fixed timestamp:
 chrona gc --now 2026-03-19T00:00:00.000Z --json
 ```
 
+### `mcp`
+
+Run the MCP server.
+
+Stdio is the default transport:
+
+```bash
+chrona mcp --db ./.chrona/chrona.db
+```
+
+Serve MCP over Streamable HTTP:
+
+```bash
+chrona mcp --db ./.chrona/chrona.db --port 3030
+```
+
+The HTTP endpoint is available at `http://127.0.0.1:3030/mcp`.
+
 ## Copy-paste examples
 
 1. Initialize a fresh database:
@@ -583,7 +660,7 @@ npm run check
 
 Current release target:
 
-- `v0.1.0`
+- `v0.1.1`
 
 ## License