mcp-task-server 0.1.0 → 0.1.2

package/README.md

@@ -74,7 +74,7 @@ npm start
 
 ## Cursor IDE Integration
 
-Add to your `.cursor/mcp.json`:
+Add to your project's `.cursor/mcp.json`:
 
 ```json
 {
@@ -82,13 +82,50 @@ Add to your `.cursor/mcp.json`:
     "task-server": {
       "command": "npx",
       "args": ["-y", "mcp-task-server"],
-      "cwd": "/path/to/your/project"
+      "cwd": "/absolute/path/to/your/project"
     }
   }
 }
 ```
 
-The `cwd` parameter sets the workspace root where task files will be stored.
+### Important: cwd Limitations
+
+The `cwd` parameter has limitations in Cursor:
+
+1. **Must be an absolute path** - Relative paths and `~` expansion do not work reliably
+2. **Set per-project** - Each project needs its own `.cursor/mcp.json` with the correct `cwd`
+3. **No dynamic resolution** - Cursor does not automatically resolve `cwd` to the current workspace
+4. **Global config issues** - If using `~/.cursor/mcp.json` (global), the `cwd` applies to all projects
+
+**Recommended setup**: Add `.cursor/mcp.json` to each project with an absolute path:
+
+```json
+{
+  "mcpServers": {
+    "task-server": {
+      "command": "npx",
+      "args": ["-y", "mcp-task-server"],
+      "cwd": "/Users/yourname/Projects/my-project"
+    }
+  }
+}
+```
+
+**Alternative**: Use environment variable for the working directory:
+
+```json
+{
+  "mcpServers": {
+    "task-server": {
+      "command": "npx",
+      "args": ["-y", "mcp-task-server"],
+      "env": {
+        "TASK_WORKSPACE": "/Users/yourname/Projects/my-project"
+      }
+    }
+  }
+}
+```
 
 ## Configuration
 
@@ -155,8 +192,8 @@ High-level overview auto-generated from tasks.json:
 ## Task Completion Summary
 
 ### Completed Tasks (3/5)
-- ✅ Task 1: Project Setup
-- ✅ Task 2: Database Schema
+- Task 1: Project Setup
+- Task 2: Database Schema
 ```
 
 This architecture scales well for complex projects with many tasks and subtasks.
@@ -299,6 +336,72 @@ If you have existing `.taskmaster/tasks.json`:
 3. Individual task files are generated
 4. Progress summary is updated
 
+## Publishing to npm
+
+### Prerequisites
+
+1. An npm account at [npmjs.com](https://www.npmjs.com/)
+2. Node.js 18+
+
+### npm Security Changes (2025+)
+
+npm has updated its security model:
+
+- **TOTP authenticator apps are deprecated** for new 2FA setups
+- **Security keys (WebAuthn/FIDO)** are now required for new 2FA configurations
+- **Automation tokens** are required for CI/CD and scripted publishing
+
+### Creating a Publish Token
+
+1. Go to [npmjs.com/settings/~/tokens](https://www.npmjs.com/settings/~/tokens)
+2. Click **Generate New Token** → **Granular Access Token**
+3. Configure:
+   - **Token name**: `mcp-task-server-publish` (or your preference)
+   - **Bypass two-factor authentication (2FA)**: Check this box (required for CLI publishing)
+   - **Allowed IP ranges**: Optional - add your IP as `x.x.x.x/32` for extra security
+   - **Packages and scopes**: Select **Read and write**, then **All packages**
+   - **Expiration**: 90 days (maximum for granular tokens)
+4. Click **Generate Token**
+5. Copy the token immediately (you won't see it again)
+
+### Publishing
+
+```bash
+# Set the token as an environment variable
+export NPM_TOKEN=npm_xxxxxxxxxxxx
+
+# Build and publish
+cd /path/to/mcp-task-server
+npm publish --//registry.npmjs.org/:_authToken=$NPM_TOKEN
+```
+
+The `prepublishOnly` script automatically runs `npm run build` before publishing.
+
+### Releasing Updates
+
+```bash
+# Bump version (updates package.json and creates git tag)
+npm version patch   # 0.1.1 -> 0.1.2
+npm version minor   # 0.1.2 -> 0.2.0
+npm version major   # 0.2.0 -> 1.0.0
+
+# Publish the new version
+npm publish --//registry.npmjs.org/:_authToken=$NPM_TOKEN
+```
+
+### Verifying Publication
+
+```bash
+npm info mcp-task-server
+```
+
+### Token Security Tips
+
+- **Regenerate tokens** before they expire (90 day limit)
+- **Use IP restrictions** if publishing from a static IP
+- **Never commit tokens** to version control
+- **Store tokens securely** (e.g., password manager, environment variables)
+
 ## Development
 
 ```bash
@@ -310,6 +413,9 @@ npm run build
 
 # Watch mode
 npm run dev
+
+# Test locally before publishing
+npm pack  # Creates .tgz file for inspection
 ```
 
 ## License

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "mcp-task-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for task management with multi-agent coordination",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
-    "mcp-task-server": "./dist/index.js"
+    "mcp-task-server": "dist/index.js"
   },
   "files": [
     "dist"