@cpenned/mcp 0.1.0

package/dist/tools/views.js

@@ -0,0 +1,77 @@
+// Opinionated read tools: computed views and the review system. Views are
+// timezone-aware (tz overrides the vault default); review tools cover the due
+// queue, garden deep-review, forcing a garden into review, and marking items
+// reviewed (which restarts their clock).
+import { z } from "zod";
+import { runTool } from "../result.js";
+const getViewSchema = z.object({
+    view: z.enum(["today", "upcoming", "anytime", "someday", "overdue"]),
+    tz: z
+        .string()
+        .optional()
+        .describe("IANA timezone (e.g. America/New_York); defaults to the vault timezone"),
+    limit: z.number().int().positive().optional(),
+    cursor: z.string().optional(),
+});
+export function getView(client, args) {
+    return client.get(`/v1/views/${args.view}`, {
+        tz: args.tz,
+        limit: args.limit,
+        cursor: args.cursor,
+    });
+}
+const getReviewsSchema = z.object({
+    gardenId: z.string().optional().describe("Restrict the due queue to one garden"),
+    limit: z.number().int().positive().optional(),
+});
+export function getReviews(client, args) {
+    return client.get("/v1/reviews", { gardenId: args.gardenId, limit: args.limit });
+}
+const gardenIdSchema = z.object({ gardenId: z.string() });
+export function reviewGarden(client, args) {
+    return client.get(`/v1/gardens/${args.gardenId}/review`);
+}
+export function requestGardenReview(client, args) {
+    return client.post(`/v1/gardens/${args.gardenId}/request-review`);
+}
+const markTaskReviewedSchema = z.object({ taskId: z.string() });
+export function markTaskReviewed(client, args) {
+    return client.post(`/v1/tasks/${args.taskId}/reviewed`);
+}
+const markProjectReviewedSchema = z.object({ projectId: z.string() });
+export function markProjectReviewed(client, args) {
+    return client.post(`/v1/projects/${args.projectId}/reviewed`);
+}
+export function registerViewTools(server, client) {
+    server.registerTool("get_view", {
+        title: "Get view",
+        description: "A computed, timezone-aware view: today / upcoming / anytime / someday / overdue.",
+        inputSchema: getViewSchema.shape,
+    }, (args) => runTool(() => getView(client, args)));
+    server.registerTool("get_reviews", {
+        title: "Get review queue",
+        description: "Items due for review now (optionally scoped to a garden).",
+        inputSchema: getReviewsSchema.shape,
+    }, (args) => runTool(() => getReviews(client, args)));
+    server.registerTool("review_garden", {
+        title: "Review garden",
+        description: "Deep-review: every active item under a garden, regardless of review readiness.",
+        inputSchema: gardenIdSchema.shape,
+    }, (args) => runTool(() => reviewGarden(client, args)));
+    server.registerTool("request_garden_review", {
+        title: "Request garden review",
+        description: "Force all of a garden's active items into the due-review queue.",
+        inputSchema: gardenIdSchema.shape,
+    }, (args) => runTool(() => requestGardenReview(client, args)));
+    server.registerTool("mark_task_reviewed", {
+        title: "Mark task reviewed",
+        description: "Restart a task's review clock (lastReviewedAt=now, nextReviewAt=+interval).",
+        inputSchema: markTaskReviewedSchema.shape,
+    }, (args) => runTool(() => markTaskReviewed(client, args)));
+    server.registerTool("mark_project_reviewed", {
+        title: "Mark project reviewed",
+        description: "Restart a project's review clock.",
+        inputSchema: markProjectReviewedSchema.shape,
+    }, (args) => runTool(() => markProjectReviewed(client, args)));
+}
+//# sourceMappingURL=views.js.map

package/dist/tools/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../src/tools/views.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@cpenned/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Open Brain - a thin adapter over the /v1 HTTP API.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Chris Pennington",
+  "homepage": "https://github.com/cpenned/open-brain/tree/main/packages/mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cpenned/open-brain.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/cpenned/open-brain/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "open-brain",
+    "tasks",
+    "todo",
+    "productivity"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "open-brain-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@mcp-ui/server": "^6.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.8"
+  }
+}