add mcp

Author: woss

.github/workflows/release.yml

@@ -24,6 +24,7 @@ jobs:
         with:
           extra_plugins: |
             @semantic-release/exec
+            @semantic-release/git
             @semantic-release/github
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.opencode/opencode.jsonc

@@ -7,7 +7,7 @@
     "gh_grep_*": "deny",
     "kagi_*": "deny",
     "webfetch": "deny",
-    "worktree_*": "deny"
+    "worktree_*": "deny",
   },
   "agent": {
     "researcher": {
@@ -59,22 +59,22 @@
           "uniq *": "allow",
           "cut *": "allow",
           "awk *": "allow",
-          "tr *": "allow"
-        }
-      }
+          "tr *": "allow",
+        },
+      },
     },
     "scribe": {
       "permission": {
         "bash": {
-          "*": "deny"
+          "*": "deny",
         },
         "edit": "allow",
         "glob": "allow",
         "read": "allow",
         "write": "allow",
         "plan_read": "deny",
-        "todoread": "deny"
-      }
+        "todoread": "deny",
+      },
     },
     "coder": {
       "permission": {
@@ -88,8 +88,8 @@
         "grep": "allow",
         "bash": "allow",
         "plan_read": "deny",
-        "todoread": "deny"
-      }
+        "todoread": "deny",
+      },
     },
     "reviewer": {
       "temperature": 0.1,
@@ -102,35 +102,35 @@
           "git log*": "allow",
           "git show*": "allow",
           "git blame*": "allow",
-          "rg *": "allow"
+          "rg *": "allow",
         },
         "plan_read": "allow",
         "delegation_read": "allow",
-        "delegation_list": "allow"
-      }
+        "delegation_list": "allow",
+      },
     },
     "plan": {
       "permission": {
         "edit": "deny",
         "write": "deny",
         "bash": {
-          "*": "deny"
+          "*": "deny",
         },
         "task": "allow",
-        "worktree_*": "allow"
-      }
+        "worktree_*": "allow",
+      },
     },
     "build": {
       "prompt": "You are a **build orchestrator**. You coordinate implementation through delegation - you do NOT implement directly.\\\\\\\\n\\\\\\\\n## Your Role\\\\\\\\n- Delegate implementation to `coder`\\\\\\\\n- Delegate documentation to `scribe`\\\\\\\\n- Delegate codebase analysis to `explore`\\\\\\\\n- Delegate external research to `researcher`\\\\\\\\n- Interpret results and decide next steps\\\\\\\\n\\\\\\\\n## Critical Constraint\\\\\\\\nYou CANNOT edit files or run commands directly. For ALL implementation and verification, delegate to `coder`.",
       "permission": {
         "edit": "deny",
         "write": "deny",
         "bash": {
-          "*": "deny"
+          "*": "deny",
         },
         "task": "allow",
-        "worktree_*": "allow"
-      }
+        "worktree_*": "allow",
+      },
     },
     "explore": {
       "permission": {
@@ -163,34 +163,45 @@
           "hostname": "allow",
           "whoami": "allow",
           "which *": "allow",
-          "realpath *": "allow"
-        }
-      }
-    }
+          "realpath *": "allow",
+        },
+      },
+    },
   },
   "mcp": {
     "context7": {
       "type": "remote",
       "url": "https://mcp.context7.com/mcp",
-      "enabled": true
+      "enabled": true,
     },
     "exa": {
       "type": "remote",
       "url": "https://mcp.exa.ai/mcp",
-      "enabled": true
+      "enabled": true,
     },
     "gh_grep": {
       "type": "remote",
       "url": "https://mcp.grep.app",
-      "enabled": true
-    }
+      "enabled": true,
+    },
+    "ocv": {
+      "type": "local",
+      "command": [
+        "deno",
+        "run",
+        "-A",
+        "main.ts",
+        "mcp"
+      ],
+      "enabled": true,
+    },
   },
   "instructions": [
     "./tools/philosophy.md"
   ],
   "plugin": [
     "@tarquinen/opencode-dcp@3.1.3",
-    "@franlol/opencode-md-table-formatter@0.0.6"
-  ]
+    "@franlol/opencode-md-table-formatter@0.0.6",
+  ],
   // Add MCP servers, tools, plugins here
 }

.releaserc.json

@@ -6,6 +6,9 @@
     ["@semantic-release/exec", {
       "prepareCmd": "echo \"export const VERSION = '${nextRelease.version}';\" > version.ts"
     }],
+    ["@semantic-release/git", {
+      "assets": ["version.ts"]
+    }],
     ["@semantic-release/github"]
   ]
 }

README.md

@@ -75,6 +75,7 @@ ocv sessions <path>        # List sessions matching directory path
 ocv session <id>           # Detailed info for a specific session
 ocv search <query>         # Search sessions by title or directory
 ocv rename --from-dir <old-dir> -d <new-dir>  # Batch-rename session directory
+ocv mcp                       # MCP stdio server for AI agent integration
 ocv --help                 # Top-level help
 ocv <command> --help       # Per-command help
 ocv --version              # Show version
@@ -91,6 +92,7 @@ ocv dash --output json               # Dashboard data as JSON
 ocv overview --output json           # Overview as JSON
 ocv search <query> --output json     # Search results as JSON
 ocv rename --from-dir ... -d ... --output json   # Rename result as JSON
+ocv mcp                       # MCP server — communicates via JSON-RPC on stdio (no --output flag)
 ```
 
 ### Excluding directories
@@ -128,6 +130,33 @@ The `sessions` and `search` commands show a "Type" column:
 - **Main** — top-level session (no parent)
 - **Sub** — subagent/delegated session (has a parent_id)
 
+### MCP server
+
+`ocv` includes a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) stdio server for AI agent tool access. Run `ocv mcp` to start the server — it communicates over stdin/stdout via JSON-RPC, exposing database queries as structured, typed tools.
+
+**Available tools:** `get_stats`, `get_overview`, `list_sessions`, `get_session`, `search_sessions`, `get_top_models`, `get_top_providers`, `get_weekly_activity`
+
+Register with OpenCode by adding to `.opencode/opencode.jsonc` in any project:
+
+```json
+"ocv": {
+  "type": "local",
+  "command": ["ocv", "mcp"],
+  "enabled": true
+}
+```
+
+Or from source (requires Deno):
+```json
+"ocv": {
+  "type": "local",
+  "command": ["deno", "run", "-A", "main.ts", "mcp"],
+  "enabled": true
+}
+```
+
+Agents in that workspace can then query session data, token usage, costs, and more through structured tool calls.
+
 ## Commands
 
 | Command                            | Description                                                                                                                |
@@ -139,6 +168,7 @@ The `sessions` and `search` commands show a "Type" column:
 | `session <id>`                     | Single session detail with messages and todo breakdown                                                                     |
 | `search <query>`                   | Full-text search over session titles and directories                                                                       |
 | `rename --from-dir <old> -d <new>` | Batch-rename session directory and path fields when project moves                                                          |
+| `mcp`                              | Start MCP stdio server — exposes DB queries as structured tools for AI agents                                               |
 
 ## Semantic versioning
 

deno.json

@@ -19,6 +19,7 @@
     "@cliffy/command": "jsr:@cliffy/command@^1.0.0-rc.7",
     "@cliffy/table": "jsr:@cliffy/table@^1.0.0-rc.7",
     "@db/sqlite": "jsr:@db/sqlite@^0.12.0",
+    "@modelcontextprotocol/sdk": "npm:@modelcontextprotocol/sdk@^1.9.0",
     "@std/path": "jsr:@std/path@^1.0.0"
   }
 }