@ezmodo/mcp-server 0.13.0

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ezmodo/mcp-server",
+  "version": "0.13.0",
+  "description": "MCP server for ezmodo - AI-first project management",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "ezmodo-mcp-server": "./index.js",
+    "zephly-mcp-server": "./index.js"
+  },
+  "scripts": {
+    "dev": "BUILD_ENV=development node index.js",
+    "start": "node index.js",
+    "build:production": "BUILD_ENV=production node --input-type=module -e 'console.log(\"Production build configured\")'",
+    "build:staging": "BUILD_ENV=staging node --input-type=module -e 'console.log(\"Staging build configured\")'",
+    "build:development": "BUILD_ENV=development node --input-type=module -e 'console.log(\"Development build configured\")'",
+    "test": "BUILD_ENV=development NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:watch": "BUILD_ENV=development NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "test:coverage": "BUILD_ENV=development NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "test:smoke": "BUILD_ENV=development node test.js",
+    "lint": "eslint . --fix"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ezmodo",
+    "ai",
+    "project-management"
+  ],
+  "author": "ezmodo Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.js",
+    "config/",
+    "handlers/",
+    "lib/",
+    "prompts/",
+    "tools/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EasyModeOnly/ezmodo.git",
+    "directory": "mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^30.3.0",
+    "eslint": "^10.8.0",
+    "jest": "^30.5.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/prompts/ai-workflow-automation.js

@@ -0,0 +1,96 @@
+/**
+ * AI Workflow Automation Prompt
+ * Guidelines for AI agents to automatically track their work in Zephly
+ */
+
+export const AI_WORKFLOW_AUTOMATION = `# AI Workflow Automation Guide
+
+## Overview
+
+When you (as an AI agent) are implementing features or working on
+complex tasks, **automatically track your work in Zephly in real-time**.
+Don't wait for users to ask you to update documentation or check off tasks.
+
+## When to Use Workflow Automation
+
+- User asks you to implement a feature (not just explain or plan)
+- Task involves multiple implementation steps (>3 steps)
+- Work needs team visibility or historical tracking
+
+## Session Setup
+
+First, discover the user's context:
+
+\`\`\`javascript
+// 1. Get organization
+const orgs = await list_organizations();
+const orgId = orgs.organizations[0].id;
+
+// 2. Get projects
+const projects = await list_projects({ organizationId: orgId });
+const projectId = projects.projects[0].id;
+\`\`\`
+
+## Workflow Steps
+
+1. **Create or Select Project** - Use existing project or create new one with \`create_project\`
+2. **Create Epic** (optional) - Use \`create_epic\` to group related tasks under a milestone
+3. **Break Down Tasks** - Create 3-7 tasks with \`create_task\`, each with implementation steps
+4. **Track Progress** - Update steps with \`update_task\` (toggle, add, modify) as you work
+5. **Update Status** - Move tasks through workflow: backlog → todo → in_progress → in_review → completed
+6. **Document** - Use \`create_document\` to create setup guides, API docs, or troubleshooting guides
+7. **Complete** - Use \`complete_task\` when done, update epic status if applicable
+
+## Example Workflow
+
+\`\`\`javascript
+// 1. Get context
+const orgs = await list_organizations();
+const orgId = orgs.organizations[0].id;
+const projects = await list_projects({ organizationId: orgId });
+const projectId = projects.projects[0].id;
+
+// 2. Create epic (milestone)
+const epic = await create_epic({
+  projectId,
+  title: "User Authentication System",
+  description: "Complete auth implementation with OAuth2"
+});
+
+// 3. Create tasks with steps
+await create_task({
+  projectId,
+  epicId: epic.id,
+  title: "Implement OAuth2 backend",
+  description: "Set up OAuth2 authentication flow",
+  steps: ["Set up OAuth2 config", "JWT generation", "Validation middleware", "Tests"],
+  assigneeType: "ai",
+  assigneeId: "claude",
+  assigneeName: "Claude"
+});
+
+// 4. Track progress as you work
+await update_task({ taskId: "task1", status: "in_progress" });
+await update_task({ taskId: "task1", toggleStep: { stepId: "step_0", completed: true } });
+
+// 5. Document what you built
+await create_document({
+  projectId,
+  title: "Authentication Setup Guide",
+  content: "# How to configure OAuth2...",
+  type: "setup"
+});
+
+// 6. Complete task
+await complete_task({ taskId: "task1", completionNotes: "OAuth2 implementation complete" });
+
+// 7. Update epic when all tasks done
+await update_epic({ epicId: epic.id, status: "completed" });
+\`\`\`
+
+## Benefits
+
+- Real-time visibility for users (no "black box" AI work)
+- Historical record of decisions and implementation details
+- Documentation created alongside code
+- The only PM tool where AI agents manage their own project tracking`;

package/prompts/index.js

@@ -0,0 +1,39 @@
+/**
+ * MCP Prompts
+ * Prompt definitions and content for the Zephly MCP server
+ */
+
+// Import prompt content from separate files (to be created)
+import { ZEPHLY_USAGE_GUIDE } from './zephly-usage-guide.js';
+import { AI_WORKFLOW_AUTOMATION } from './ai-workflow-automation.js';
+
+/**
+ * List of available prompts
+ */
+export const PROMPTS = [
+  {
+    name: 'zephly-usage-guide',
+    description: 'Guidelines for using Zephly MCP tools effectively in project management workflows',
+  },
+  {
+    name: 'ai-workflow-automation',
+    description: 'Guidelines for AI agents to automatically track '
+      + 'their work in Zephly (create epics, tasks, steps, and documentation)',
+  },
+];
+
+/**
+ * Get prompt content by name
+ * @param {string} name - Prompt name
+ * @returns {string|null} - Prompt content or null if not found
+ */
+export function getPromptContent(name) {
+  switch (name) {
+  case 'zephly-usage-guide':
+    return ZEPHLY_USAGE_GUIDE;
+  case 'ai-workflow-automation':
+    return AI_WORKFLOW_AUTOMATION;
+  default:
+    return null;
+  }
+}