@xferops/forge-mcp 2.0.0

package/src/index.ts

@@ -0,0 +1,1006 @@
+#!/usr/bin/env node
+
+/**
+ * Forge MCP Server
+ *
+ * MCP (Model Context Protocol) server for interacting with the Forge API.
+ * Forge is XferOps' project management system (formerly Flower/Kanban).
+ *
+ * Works with: Claude Code, OpenAI Codex, OpenClaw/mcporter, and any MCP consumer.
+ *
+ * @see https://forge.xferops.dev/docs for API documentation
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Configuration
+// Accepts FORGE_* (preferred) or FLOWER_* (legacy, backward compat)
+// ─────────────────────────────────────────────────────────────────────────────
+
+const FORGE_URL =
+  process.env.FORGE_URL ||
+  process.env.FLOWER_URL ||
+  process.env.KANBAN_URL ||
+  "https://forge.xferops.dev";
+
+const FORGE_TOKEN =
+  process.env.FORGE_TOKEN ||
+  process.env.FLOWER_TOKEN ||
+  process.env.KANBAN_TOKEN ||
+  "";
+
+if (!FORGE_TOKEN) {
+  console.error("⚠️  Warning: FORGE_TOKEN environment variable not set");
+  console.error("   Get your token at: https://forge.xferops.dev/settings");
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// API Client
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface ApiError {
+  error: string;
+  details?: Array<{ field: string; message: string }>;
+}
+
+async function apiCall<T = unknown>(
+  path: string,
+  options: RequestInit = {}
+): Promise<T> {
+  const url = `${FORGE_URL}${path}`;
+
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${FORGE_TOKEN}`,
+      ...options.headers,
+    },
+  });
+
+  const data = await res.json();
+
+  if (!res.ok) {
+    const apiError = data as ApiError;
+    const message = apiError.details
+      ? apiError.details.map((d) => `${d.field}: ${d.message}`).join(", ")
+      : apiError.error || `HTTP ${res.status}`;
+    throw new Error(message);
+  }
+
+  return data as T;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Type Definitions
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface User {
+  id: string;
+  name: string;
+  email: string;
+}
+
+interface TeamMember {
+  userId: string;
+  role: "OWNER" | "ADMIN" | "MEMBER";
+  user: User;
+}
+
+interface Team {
+  id: string;
+  name: string;
+  slug: string;
+  members?: TeamMember[];
+  projects?: ProjectSummary[];
+}
+
+interface ProjectSummary {
+  id: string;
+  name: string;
+  slug: string;
+}
+
+interface Column {
+  id: string;
+  name: string;
+  position: number;
+  tasks?: Task[];
+}
+
+interface Task {
+  id: string;
+  ticketNumber: number;
+  ticketId: string;
+  title: string;
+  description: string | null;
+  position: number;
+  priority: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+  type: "TASK" | "BUG" | "STORY";
+  columnId: string;
+  projectId: string;
+  assignees?: Array<{ user: User }>;
+  creator?: User;
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface Project {
+  id: string;
+  name: string;
+  slug: string;
+  teamId: string;
+  prefix: string | null;
+  nextTicketNumber: number;
+  columns: Column[];
+}
+
+interface Comment {
+  id: string;
+  content: string;
+  taskId: string;
+  userId: string;
+  user: User;
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface SearchResult {
+  tasks: Task[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Implementations - Health
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function healthCheck(): Promise<{ status: string; url: string }> {
+  const data = await apiCall<{ status: string }>("/api/health");
+  return { ...data, url: FORGE_URL };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Implementations - Teams
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function listTeams(): Promise<Team[]> {
+  return apiCall<Team[]>("/api/teams");
+}
+
+async function createTeam(name: string): Promise<Team> {
+  return apiCall<Team>("/api/teams", {
+    method: "POST",
+    body: JSON.stringify({ name }),
+  });
+}
+
+async function listTeamMembers(teamId: string): Promise<TeamMember[]> {
+  return apiCall<TeamMember[]>(`/api/teams/${teamId}/members`);
+}
+
+async function addTeamMember(
+  teamId: string,
+  email: string,
+  role?: string
+): Promise<TeamMember> {
+  return apiCall<TeamMember>(`/api/teams/${teamId}/members`, {
+    method: "POST",
+    body: JSON.stringify({ email, role: role || "MEMBER" }),
+  });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Implementations - Projects
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function listProjects(teamId: string): Promise<ProjectSummary[]> {
+  return apiCall<ProjectSummary[]>(`/api/teams/${teamId}/projects`);
+}
+
+async function getProject(projectId: string): Promise<Project> {
+  return apiCall<Project>(`/api/projects/${projectId}`);
+}
+
+async function createProject(
+  teamId: string,
+  name: string,
+  prefix?: string
+): Promise<Project> {
+  return apiCall<Project>(`/api/teams/${teamId}/projects`, {
+    method: "POST",
+    body: JSON.stringify({ name, prefix }),
+  });
+}
+
+async function updateProject(
+  projectId: string,
+  updates: { name?: string; prefix?: string }
+): Promise<Project> {
+  return apiCall<Project>(`/api/projects/${projectId}`, {
+    method: "PATCH",
+    body: JSON.stringify(updates),
+  });
+}
+
+async function deleteProject(projectId: string): Promise<{ success: boolean }> {
+  await apiCall(`/api/projects/${projectId}`, { method: "DELETE" });
+  return { success: true };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Implementations - Columns
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function createColumn(projectId: string, name: string): Promise<Column> {
+  return apiCall<Column>("/api/columns", {
+    method: "POST",
+    body: JSON.stringify({ projectId, name }),
+  });
+}
+
+async function updateColumn(
+  columnId: string,
+  updates: { name?: string }
+): Promise<Column> {
+  return apiCall<Column>(`/api/columns/${columnId}`, {
+    method: "PATCH",
+    body: JSON.stringify(updates),
+  });
+}
+
+async function deleteColumn(
+  columnId: string,
+  moveTasksTo?: string
+): Promise<{ success: boolean }> {
+  const url = moveTasksTo
+    ? `/api/columns/${columnId}?moveTasksTo=${moveTasksTo}`
+    : `/api/columns/${columnId}`;
+  await apiCall(url, { method: "DELETE" });
+  return { success: true };
+}
+
+async function reorderColumns(
+  projectId: string,
+  columnIds: string[]
+): Promise<{ success: boolean }> {
+  await apiCall("/api/columns/reorder", {
+    method: "POST",
+    body: JSON.stringify({ projectId, columnIds }),
+  });
+  return { success: true };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Implementations - Tasks
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function getTask(taskId: string): Promise<Task> {
+  return apiCall<Task>(`/api/tasks/${taskId}`);
+}
+
+async function listTasks(projectId: string): Promise<Task[]> {
+  const project = await apiCall<Project>(`/api/projects/${projectId}`);
+  const tasks: Task[] = [];
+  for (const column of project.columns || []) {
+    if (column.tasks) {
+      tasks.push(...column.tasks);
+    }
+  }
+  return tasks;
+}
+
+async function searchTasks(query: string, projectId?: string): Promise<Task[]> {
+  const params = new URLSearchParams({ q: query });
+  if (projectId) params.append("projectId", projectId);
+  const result = await apiCall<SearchResult>(`/api/tasks/search?${params}`);
+  return result.tasks;
+}
+
+async function createTask(params: {
+  projectId: string;
+  columnId: string;
+  title: string;
+  description?: string;
+  type?: "TASK" | "BUG" | "STORY";
+  priority?: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+  assigneeId?: string;
+}): Promise<Task> {
+  return apiCall<Task>("/api/tasks", {
+    method: "POST",
+    body: JSON.stringify(params),
+  });
+}
+
+async function updateTask(
+  taskId: string,
+  updates: {
+    title?: string;
+    description?: string;
+    columnId?: string;
+    assigneeId?: string | null;
+    priority?: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+    type?: "TASK" | "BUG" | "STORY";
+    prUrl?: string | null;
+    prNumber?: number | null;
+    prRepo?: string | null;
+  }
+): Promise<Task> {
+  return apiCall<Task>(`/api/tasks/${taskId}`, {
+    method: "PATCH",
+    body: JSON.stringify(updates),
+  });
+}
+
+async function moveTask(taskId: string, columnId: string): Promise<Task> {
+  return apiCall<Task>(`/api/tasks/${taskId}`, {
+    method: "PATCH",
+    body: JSON.stringify({ columnId }),
+  });
+}
+
+async function deleteTask(taskId: string): Promise<{ success: boolean }> {
+  await apiCall(`/api/tasks/${taskId}`, { method: "DELETE" });
+  return { success: true };
+}
+
+async function reorderTask(
+  taskId: string,
+  columnId: string,
+  position: number
+): Promise<{ success: boolean }> {
+  await apiCall("/api/tasks/reorder", {
+    method: "POST",
+    body: JSON.stringify({ taskId, columnId, position }),
+  });
+  return { success: true };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Implementations - Comments
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function listComments(taskId: string): Promise<Comment[]> {
+  return apiCall<Comment[]>(`/api/comments?taskId=${taskId}`);
+}
+
+async function createComment(taskId: string, content: string): Promise<Comment> {
+  return apiCall<Comment>("/api/comments", {
+    method: "POST",
+    body: JSON.stringify({ taskId, content }),
+  });
+}
+
+async function updateComment(commentId: string, content: string): Promise<Comment> {
+  return apiCall<Comment>(`/api/comments/${commentId}`, {
+    method: "PATCH",
+    body: JSON.stringify({ content }),
+  });
+}
+
+async function deleteComment(commentId: string): Promise<{ success: boolean }> {
+  await apiCall(`/api/comments/${commentId}`, { method: "DELETE" });
+  return { success: true };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// MCP Server Setup
+// ─────────────────────────────────────────────────────────────────────────────
+
+const server = new Server(
+  {
+    name: "forge-mcp",
+    version: "2.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Definitions
+// ─────────────────────────────────────────────────────────────────────────────
+
+const tools = [
+  // Health
+  {
+    name: "forge_health_check",
+    description:
+      "Check if the Forge API is healthy and reachable. Returns the API status and configured URL.",
+    inputSchema: { type: "object", properties: {} },
+  },
+
+  // Teams
+  {
+    name: "forge_list_teams",
+    description:
+      "List all teams you belong to. Returns team IDs needed for other operations.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "forge_create_team",
+    description: "Create a new team. You become the owner.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Team name (e.g., 'Engineering', 'Product')",
+        },
+      },
+      required: ["name"],
+    },
+  },
+  {
+    name: "forge_list_team_members",
+    description:
+      "List all members of a team with their roles. Useful for finding user IDs for task assignment.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: { type: "string", description: "Team ID" },
+      },
+      required: ["teamId"],
+    },
+  },
+  {
+    name: "forge_add_team_member",
+    description: "Add a user to a team by their email address.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: { type: "string", description: "Team ID" },
+        email: {
+          type: "string",
+          description: "Email address of the user to add",
+        },
+        role: {
+          type: "string",
+          enum: ["ADMIN", "MEMBER"],
+          description: "Role to assign (default: MEMBER)",
+        },
+      },
+      required: ["teamId", "email"],
+    },
+  },
+
+  // Projects
+  {
+    name: "forge_list_projects",
+    description: "List all projects in a team.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: { type: "string", description: "Team ID" },
+      },
+      required: ["teamId"],
+    },
+  },
+  {
+    name: "forge_get_project",
+    description:
+      "Get full project details including all columns and tasks. This is the main way to see the board state.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+      },
+      required: ["projectId"],
+    },
+  },
+  {
+    name: "forge_create_project",
+    description: "Create a new project (board) in a team.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: { type: "string", description: "Team ID" },
+        name: {
+          type: "string",
+          description:
+            "Project name (e.g., 'Q1 Sprint', 'Product Roadmap')",
+        },
+        prefix: {
+          type: "string",
+          description:
+            "Optional ticket prefix (e.g., 'PROD' for PROD-123 style tickets)",
+        },
+      },
+      required: ["teamId", "name"],
+    },
+  },
+  {
+    name: "forge_update_project",
+    description: "Update project name or ticket prefix.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        name: { type: "string", description: "New project name" },
+        prefix: { type: "string", description: "New ticket prefix" },
+      },
+      required: ["projectId"],
+    },
+  },
+  {
+    name: "forge_delete_project",
+    description:
+      "Delete a project and all its columns/tasks. This cannot be undone!",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to delete" },
+      },
+      required: ["projectId"],
+    },
+  },
+
+  // Columns
+  {
+    name: "forge_create_column",
+    description:
+      "Create a new column in a project board (e.g., 'Backlog', 'In Progress', 'Done').",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        name: { type: "string", description: "Column name" },
+      },
+      required: ["projectId", "name"],
+    },
+  },
+  {
+    name: "forge_update_column",
+    description: "Rename a column.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        columnId: { type: "string", description: "Column ID" },
+        name: { type: "string", description: "New column name" },
+      },
+      required: ["columnId", "name"],
+    },
+  },
+  {
+    name: "forge_delete_column",
+    description:
+      "Delete a column. If the column has tasks, you must specify where to move them.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        columnId: { type: "string", description: "Column ID to delete" },
+        moveTasksTo: {
+          type: "string",
+          description:
+            "Column ID to move existing tasks to (required if column has tasks)",
+        },
+      },
+      required: ["columnId"],
+    },
+  },
+  {
+    name: "forge_reorder_columns",
+    description:
+      "Reorder columns in a project by providing the column IDs in the desired order.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        columnIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Array of column IDs in the desired order",
+        },
+      },
+      required: ["projectId", "columnIds"],
+    },
+  },
+
+  // Tasks
+  {
+    name: "forge_get_task",
+    description: "Get a single task by ID with all its details.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID" },
+      },
+      required: ["taskId"],
+    },
+  },
+  {
+    name: "forge_list_tasks",
+    description: "List all tasks in a project (from all columns).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+      },
+      required: ["projectId"],
+    },
+  },
+  {
+    name: "forge_search_tasks",
+    description:
+      "Search tasks by title, description, or ticket ID (e.g., '#123' or 'PROJ-123').",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search query" },
+        projectId: {
+          type: "string",
+          description: "Optional: limit search to a specific project",
+        },
+      },
+      required: ["query"],
+    },
+  },
+  {
+    name: "forge_create_task",
+    description: "Create a new task in a project column.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID" },
+        columnId: {
+          type: "string",
+          description: "Column ID to place the task in",
+        },
+        title: { type: "string", description: "Task title" },
+        description: {
+          type: "string",
+          description: "Task description (supports markdown)",
+        },
+        type: {
+          type: "string",
+          enum: ["TASK", "BUG", "STORY"],
+          description: "Task type (default: TASK)",
+        },
+        priority: {
+          type: "string",
+          enum: ["LOW", "MEDIUM", "HIGH", "URGENT"],
+          description: "Priority level (default: MEDIUM)",
+        },
+        assigneeId: {
+          type: "string",
+          description: "User ID to assign the task to",
+        },
+      },
+      required: ["projectId", "columnId", "title"],
+    },
+  },
+  {
+    name: "forge_update_task",
+    description:
+      "Update a task. Use columnId to move it to a different column.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID" },
+        title: { type: "string", description: "New title" },
+        description: { type: "string", description: "New description" },
+        columnId: { type: "string", description: "Move to this column ID" },
+        assigneeId: {
+          type: "string",
+          description: "Assign to this user ID (use null to unassign)",
+        },
+        priority: {
+          type: "string",
+          enum: ["LOW", "MEDIUM", "HIGH", "URGENT"],
+          description: "New priority",
+        },
+        type: {
+          type: "string",
+          enum: ["TASK", "BUG", "STORY"],
+          description: "New type",
+        },
+        prUrl: { type: "string", description: "Link to a Pull Request" },
+        prNumber: { type: "number", description: "PR number" },
+        prRepo: {
+          type: "string",
+          description: "PR repository (e.g., 'XferOps/nexus')",
+        },
+      },
+      required: ["taskId"],
+    },
+  },
+  {
+    name: "forge_move_task",
+    description:
+      "Move a task to a different column. Convenience wrapper around forge_update_task.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID to move" },
+        columnId: { type: "string", description: "Target column ID" },
+      },
+      required: ["taskId", "columnId"],
+    },
+  },
+  {
+    name: "forge_delete_task",
+    description:
+      "Delete a task and all its comments. This cannot be undone!",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID to delete" },
+      },
+      required: ["taskId"],
+    },
+  },
+  {
+    name: "forge_reorder_task",
+    description:
+      "Move a task to a specific position within a column (for drag-and-drop reordering).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID to move" },
+        columnId: { type: "string", description: "Target column ID" },
+        position: {
+          type: "number",
+          description: "Target position (0-indexed)",
+        },
+      },
+      required: ["taskId", "columnId", "position"],
+    },
+  },
+
+  // Comments
+  {
+    name: "forge_list_comments",
+    description: "List all comments on a task.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID" },
+      },
+      required: ["taskId"],
+    },
+  },
+  {
+    name: "forge_create_comment",
+    description: "Add a comment to a task.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "Task ID" },
+        content: {
+          type: "string",
+          description: "Comment content (supports markdown)",
+        },
+      },
+      required: ["taskId", "content"],
+    },
+  },
+  {
+    name: "forge_update_comment",
+    description: "Update a comment you authored.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        commentId: { type: "string", description: "Comment ID" },
+        content: { type: "string", description: "New comment content" },
+      },
+      required: ["commentId", "content"],
+    },
+  },
+  {
+    name: "forge_delete_comment",
+    description: "Delete a comment you authored.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        commentId: { type: "string", description: "Comment ID" },
+      },
+      required: ["commentId"],
+    },
+  },
+];
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Call Handler
+// ─────────────────────────────────────────────────────────────────────────────
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    let result: unknown;
+
+    switch (name) {
+      // Health
+      case "forge_health_check":
+        result = await healthCheck();
+        break;
+
+      // Teams
+      case "forge_list_teams":
+        result = await listTeams();
+        break;
+      case "forge_create_team":
+        result = await createTeam(args?.name as string);
+        break;
+      case "forge_list_team_members":
+        result = await listTeamMembers(args?.teamId as string);
+        break;
+      case "forge_add_team_member":
+        result = await addTeamMember(
+          args?.teamId as string,
+          args?.email as string,
+          args?.role as string | undefined
+        );
+        break;
+
+      // Projects
+      case "forge_list_projects":
+        result = await listProjects(args?.teamId as string);
+        break;
+      case "forge_get_project":
+        result = await getProject(args?.projectId as string);
+        break;
+      case "forge_create_project":
+        result = await createProject(
+          args?.teamId as string,
+          args?.name as string,
+          args?.prefix as string | undefined
+        );
+        break;
+      case "forge_update_project":
+        result = await updateProject(args?.projectId as string, {
+          name: args?.name as string | undefined,
+          prefix: args?.prefix as string | undefined,
+        });
+        break;
+      case "forge_delete_project":
+        result = await deleteProject(args?.projectId as string);
+        break;
+
+      // Columns
+      case "forge_create_column":
+        result = await createColumn(
+          args?.projectId as string,
+          args?.name as string
+        );
+        break;
+      case "forge_update_column":
+        result = await updateColumn(args?.columnId as string, {
+          name: args?.name as string | undefined,
+        });
+        break;
+      case "forge_delete_column":
+        result = await deleteColumn(
+          args?.columnId as string,
+          args?.moveTasksTo as string | undefined
+        );
+        break;
+      case "forge_reorder_columns":
+        result = await reorderColumns(
+          args?.projectId as string,
+          args?.columnIds as string[]
+        );
+        break;
+
+      // Tasks
+      case "forge_get_task":
+        result = await getTask(args?.taskId as string);
+        break;
+      case "forge_list_tasks":
+        result = await listTasks(args?.projectId as string);
+        break;
+      case "forge_search_tasks":
+        result = await searchTasks(
+          args?.query as string,
+          args?.projectId as string | undefined
+        );
+        break;
+      case "forge_create_task":
+        result = await createTask({
+          projectId: args?.projectId as string,
+          columnId: args?.columnId as string,
+          title: args?.title as string,
+          description: args?.description as string | undefined,
+          type: args?.type as "TASK" | "BUG" | "STORY" | undefined,
+          priority: args?.priority as
+            | "LOW"
+            | "MEDIUM"
+            | "HIGH"
+            | "URGENT"
+            | undefined,
+          assigneeId: args?.assigneeId as string | undefined,
+        });
+        break;
+      case "forge_update_task":
+        result = await updateTask(args?.taskId as string, {
+          title: args?.title as string | undefined,
+          description: args?.description as string | undefined,
+          columnId: args?.columnId as string | undefined,
+          assigneeId: args?.assigneeId as string | null | undefined,
+          priority: args?.priority as
+            | "LOW"
+            | "MEDIUM"
+            | "HIGH"
+            | "URGENT"
+            | undefined,
+          type: args?.type as "TASK" | "BUG" | "STORY" | undefined,
+          prUrl: args?.prUrl as string | null | undefined,
+          prNumber: args?.prNumber as number | null | undefined,
+          prRepo: args?.prRepo as string | null | undefined,
+        });
+        break;
+      case "forge_move_task":
+        result = await moveTask(
+          args?.taskId as string,
+          args?.columnId as string
+        );
+        break;
+      case "forge_delete_task":
+        result = await deleteTask(args?.taskId as string);
+        break;
+      case "forge_reorder_task":
+        result = await reorderTask(
+          args?.taskId as string,
+          args?.columnId as string,
+          args?.position as number
+        );
+        break;
+
+      // Comments
+      case "forge_list_comments":
+        result = await listComments(args?.taskId as string);
+        break;
+      case "forge_create_comment":
+        result = await createComment(
+          args?.taskId as string,
+          args?.content as string
+        );
+        break;
+      case "forge_update_comment":
+        result = await updateComment(
+          args?.commentId as string,
+          args?.content as string
+        );
+        break;
+      case "forge_delete_comment":
+        result = await deleteComment(args?.commentId as string);
+        break;
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [{ type: "text", text: `Error: ${message}` }],
+      isError: true,
+    };
+  }
+});
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Start Server
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("⚒️  Forge MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Failed to start Forge MCP server:", error);
+  process.exit(1);
+});