@devpad/mcp 1.7.4 → 2.0.1

package/README.md

@@ -2,24 +2,17 @@
 
 MCP (Model Context Protocol) server for devpad - exposes devpad API functionality for AI assistants like Claude.
 
-## Installation
-
-```bash
-npm install -g @devpad/mcp
-# or
-bunx @devpad/mcp
-```
+## Get an API Key
 
-## Usage
+1. Sign up at [devpad.tools](https://devpad.tools)
+2. Go to [devpad.tools/account](https://devpad.tools/account)
+3. Generate an API key
 
-### Environment Variables
-
-- `DEVPAD_API_KEY` (required): Your devpad API key from https://devpad.tools/account
-- `DEVPAD_BASE_URL` (optional): Base URL for devpad API (defaults to https://devpad.tools/api/v1)
+## Installation
 
-### Claude Desktop Configuration
+### Claude Desktop
 
-Add this to your Claude Desktop configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
 ```json
 {
@@ -28,80 +21,92 @@ Add this to your Claude Desktop configuration file (`~/Library/Application Suppo
       "command": "bunx",
       "args": ["@devpad/mcp"],
       "env": {
-        "DEVPAD_API_KEY": "your-api-key-here"
+        "DEVPAD_API_KEY": "your-api-key"
       }
     }
   }
 }
 ```
 
-Or if you have the package installed locally:
+### opencode
+
+Add to `~/.config/opencode/opencode.json`:
 
 ```json
 {
-  "mcpServers": {
+  "mcp": {
     "devpad": {
-      "command": "node",
-      "args": ["path/to/devpad/packages/mcp/dist/index.js"],
-      "env": {
-        "DEVPAD_API_KEY": "your-api-key-here"
+      "type": "local",
+      "command": ["bunx", "@devpad/mcp"],
+      "environment": {
+        "DEVPAD_API_KEY": "your-api-key"
       }
     }
   }
 }
 ```
 
+### Other MCP Clients
+
+Run the server directly:
+
+```bash
+export DEVPAD_API_KEY="your-api-key"
+bunx @devpad/mcp
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `DEVPAD_API_KEY` | Yes | Your API key from devpad.tools/account |
+| `DEVPAD_BASE_URL` | No | API base URL (default: https://devpad.tools/api/v1) |
+
 ## Available Tools
 
-The MCP server exposes all devpad API functionality as tools:
+The MCP server exposes 46 tools for managing your devpad data:
 
 ### Projects
 - `devpad_projects_list` - List all projects
-- `devpad_projects_create` - Create a new project
 - `devpad_projects_get` - Get project by ID or name
-- `devpad_projects_update` - Update an existing project
+- `devpad_projects_upsert` - Create or update a project
 
 ### Tasks
-- `devpad_tasks_list` - List tasks (with optional filters)
-- `devpad_tasks_create` - Create a new task
-- `devpad_tasks_update` - Update an existing task
+- `devpad_tasks_list` - List tasks with optional filters
 - `devpad_tasks_get` - Get task by ID
+- `devpad_tasks_upsert` - Create or update a task
+- `devpad_tasks_delete` - Delete a task
+- `devpad_tasks_history` - Get task edit history
 
 ### Milestones
 - `devpad_milestones_list` - List milestones
-- `devpad_milestones_create` - Create a new milestone
-- `devpad_milestones_update` - Update an existing milestone
+- `devpad_milestones_upsert` - Create or update a milestone
 
 ### Goals
 - `devpad_goals_list` - List goals
-- `devpad_goals_create` - Create a new goal
+- `devpad_goals_upsert` - Create or update a goal
 
 ### Tags
-- `devpad_tags_list` - List tags
+- `devpad_tags_list` - List all tags
 
 ### GitHub Integration
-- `devpad_github_repos` - List GitHub repositories
+- `devpad_github_repos` - List linked GitHub repositories
 - `devpad_github_branches` - List branches for a repository
 
-## Example Usage in Claude
+## Example Prompts
 
-Once configured, you can use natural language in Claude:
+Once configured, use natural language with your AI assistant:
 
 - "List my devpad projects"
-- "Create a new project called 'My App' with description 'A cool new app'"
-- "Show me all tasks for project XYZ"
-- "Create a milestone for Q1 2024"
-- "What are my current goals?"
+- "Show me all tasks for the devpad project"
+- "Create a task called 'Fix login bug' in project X with high priority"
+- "What milestones do I have?"
+- "Mark task ABC as done"
 
 ## Development
 
 ```bash
-# Install dependencies
 bun install
-
-# Build
 bun run build
-
-# Run locally for testing
 DEVPAD_API_KEY=your-key bun run dev
 ```

package/dist/index.js

@@ -12153,6 +12153,7 @@ class ApiClient {
     this.default_headers = options.default_headers ?? {};
     this.custom_fetch = options.custom_fetch;
     this.request_history = new ArrayBufferedQueue(options.max_history_size ?? 5);
+    this.debug = options.debug ?? false;
   }
   buildUrl(path, query) {
     const url = new URL(`${this.base_url}${path}`);
@@ -12173,10 +12174,9 @@ class ApiClient {
     const requestId = this.generateRequestId();
     const startTime = Date.now();
     const timestamp = new Date().toISOString();
-    console.log(`[DEBUG][${this.category}] ${method} ${path} [${requestId}]`, {
-      body,
-      query
-    });
+    if (this.debug) {
+      console.log(`[DEBUG][${this.category}] ${method} ${path} [${requestId}]`, { body, query });
+    }
     const request_headers = {
       "Content-Type": "application/json",
       "X-Request-ID": requestId,
@@ -12214,12 +12214,14 @@ class ApiClient {
       historyEntry.status = response.status;
       historyEntry.duration = duration;
       if (!response.ok) {
-        console.log(`[ERROR][${this.category}] ${method} ${path} [${requestId}] failed`, {
-          status: response.status,
-          duration: `${duration}ms`,
-          body,
-          query
-        });
+        if (this.debug) {
+          console.log(`[ERROR][${this.category}] ${method} ${path} [${requestId}] failed`, {
+            status: response.status,
+            duration: `${duration}ms`,
+            body,
+            query
+          });
+        }
         try {
           handleHttpResponse(response);
           await handleResponseError(response);
@@ -12246,20 +12248,24 @@ class ApiClient {
           }
         }
       }
-      console.log(`[INFO][${this.category}] ${method} ${path} [${requestId}] completed`, {
-        status: response.status,
-        duration: `${duration}ms`
-      });
+      if (this.debug) {
+        console.log(`[INFO][${this.category}] ${method} ${path} [${requestId}] completed`, {
+          status: response.status,
+          duration: `${duration}ms`
+        });
+      }
       return result;
     } catch (error) {
       const duration = Date.now() - startTime;
-      console.log(`[ERROR][${this.category}] ${method} ${path} [${requestId}] failed`, {
-        url,
-        duration: `${duration}ms`,
-        error: error instanceof Error ? error.message : String(error),
-        body,
-        query
-      });
+      if (this.debug) {
+        console.log(`[ERROR][${this.category}] ${method} ${path} [${requestId}] failed`, {
+          url,
+          duration: `${duration}ms`,
+          error: error instanceof Error ? error.message : String(error),
+          body,
+          query
+        });
+      }
       if (error instanceof ApiError || error instanceof AuthenticationError) {
         throw error;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devpad/mcp",
-  "version": "1.7.4",
+  "version": "2.0.1",
   "description": "MCP server for devpad - exposes devpad API functionality via Model Context Protocol",
   "type": "module",
   "main": "dist/index.js",
@@ -8,14 +8,12 @@
     "devpad-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node",
+    "build": "bun build src/index.ts --outdir dist --target node --packages=bundle",
     "dev": "bun run src/index.ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@devpad/api": "^1.7.4",
-    "@devpad/schema": "^1.7.4",
     "@modelcontextprotocol/sdk": "^1.17.5",
     "zod": "^3.22.4",
     "zod-to-json-schema": "^3.24.6"