Project Handoffs MCP Server

Instructions

Implementation Reference

• src/index.ts:244-256 (handler)

  Core handler function in ProjectManager that loads project data, filters open next steps, and sorts them by priority.

  async getLatestNextSteps(projectId: string): Promise<NextStep[]> {
    const data = await this.loadProjectData(projectId);
    return data.nextSteps
      .filter(step => step.status === 'open')
      .sort((a, b) => {
        const priorityOrder = {
          'core-critical': 0,
          'full-required': 1,
          'enhancement': 2
        };
        return priorityOrder[a.priority] - priorityOrder[b.priority];
      });
  }

• src/index.ts:383-393 (registration)

  Tool registration in listTools handler, including name, description, and input schema.

  {
    name: "get_latest_next_steps",
    description: "Get open next steps ordered by priority",
    inputSchema: {
      type: "object",
      properties: {
        projectId: { type: "string", description: "Project identifier" }
      },
      required: ["projectId"]
    }
  },

• src/index.ts:499-506 (handler)

  Dispatcher in CallToolRequestSchema handler that invokes the core handler and returns JSON response.

  case "get_latest_next_steps":
    const steps = await projectManager.getLatestNextSteps(args.projectId as string);
    return {
      content: [{
        type: "text",
        text: JSON.stringify(steps, null, 2)
      }]
    };