MCP Tasks

Instructions

Implementation Reference

• src/tools.ts:28-33 (handler)

  Core handler logic for the 'tasks_setup' tool (prefixed name for internal 'setup' tool). Parses the source file, registers it using sources.register, and returns a JSON summary via getSummary.

  handler: (args) => {
    storage.getParser(args.source_path)
    // Register the source and get ID
    const source = sources.register(args.source_path, args.workspace)
    return getSummary(source.id)
  },

• src/tools.ts:15-18 (schema)

  Zod input schema definition for the tasks_setup tool, including workspace (optional) and source_path.

  schema: z.object({
    workspace: z.string().optional().describe('Workspace/project directory path (provided by the IDE or use $PWD)'),
    source_path: schemas.sourcePath,
  }),

• src/server.ts:15-42 (registration)

  Registration loop in MCP server that adds all tools from tools.ts (including tasks_setup) to the FastMCP server instance.

  // Register all tools & resources
  for (const tool of Object.values(tools)) {
    if (!tool.isEnabled) {
      continue
    }
    if (tool.isResource) {
      // Register as resource
      server.addResource({
        uri: `resource://${tool.name}`,
        name: tool.description,
        mimeType: 'text/plain',
        load: () => cli.runTool(tool, []).then(text => ({ text })),
      })
    } else {
      // Register as tool with enhanced logging
      server.addTool({
        annotations: {
          openWorldHint: false, // This tool doesn't interact with external systems
          readOnlyHint: tool.isReadOnly,
          title: tool.name,
        },
        name: tool.name,
        description: tool.description,
        parameters: tool.schema,
        execute: (args) => cli.runTool(tool, args),
      })
    }
  }

• src/tools.ts:197-214 (helper)

  defineTool helper that wraps the tool definition, sets the name to 'tasks_setup' based on env.PREFIX_TOOLS, and adds default properties.

  function defineTool<S extends ZodSchema>(name: string, tool: {
    schema: S
    description: string
    isResource?: boolean
    isReadOnly?: boolean
    isEnabled?: boolean
    handler: (args: z.infer<S>, context?: any) => any
    fromArgs: (args: string[]) => z.infer<S>
  }) {
    const toolName = env.PREFIX_TOOLS ? `tasks_${name}` : name
    return {
      ...tool,
      name: toolName,
      isResource: tool.isResource ?? false,
      isReadOnly: tool.isReadOnly ?? false,
      isEnabled: tool.isEnabled ?? true,
    }
  }

• src/sources.ts:27-41 (helper)

  sources.register helper called by tasks_setup handler to register the source file path (making absolute if needed) and persist to SOURCES_PATH, returning the Source object with ID.

  register(sourcePath: string, workspace = CWD): Source {
    let path = sourcePath
    if (!isAbsolute(path)) {
      if (!workspace) {
        throw new Error('You must specify a workspace directory when registering a relative path.')
      }
      path = util.resolve(path, workspace)
    }
    const list = sources.raw()
    // Remove if exists and add to front (LIFO)
    const filtered = list.filter(s => s.path !== path)
    const source: SourceRaw = { path, workspace }
    util.writeFile(SOURCES_PATH, JSON.stringify([source, ...filtered]))
    return sources.fromRaw(source)
  },