CoderSwap MCP Server

Instructions

Implementation Reference

• src/index.ts:652-695 (handler)

  The asynchronous handler function that executes the core logic of the 'coderswap_log_session_note' tool. It checks for guardrail bypasses, generates a note ID, logs the session note details using the log utility, and returns structured output with success or error response.

  async ({ project_id, summary_text, job_id, ingestion_metrics, tags }) => {
    if (containsGuardrailBypass({ project_id, summary_text, job_id, ingestion_metrics, tags })) {
      return guardrailViolationResponse()
    }
    try {
      log('debug', 'Logging session note', { project_id, job_id })
  
      // Generate a simple note ID
      const timestamp = new Date().toISOString()
      const note_id = `note_${Date.now()}`
  
      // Log the note (for now, just to console/debug)
      log('info', `Session note logged for project ${project_id}`, {
        note_id,
        summary_text,
        job_id,
        ingestion_metrics,
        tags
      })
  
      const output = {
        note_id,
        project_id,
        timestamp
      }
  
      return {
        content: [{
          type: 'text',
          text: `✓ Logged session note: ${summary_text.substring(0, 100)}${summary_text.length > 100 ? '...' : ''}`
        }],
        structuredContent: output
      }
    } catch (error) {
      log('error', 'Failed to log session note', { project_id, error: error instanceof Error ? error.message : error })
      return {
        content: [{
          type: 'text',
          text: `✗ Failed to log session note: ${error instanceof Error ? error.message : 'Unknown error'}`
        }],
        isError: true
      }
    }
  }

• src/index.ts:636-650 (schema)

  The inputSchema and outputSchema definitions using Zod for validating the tool's inputs (project_id, summary_text, etc.) and outputs (note_id, etc.). Includes title and description.

  {
    title: 'Log Session Note',
    description: 'Record lightweight ingestion summary for session continuity (non-DSL)',
    inputSchema: {
      project_id: z.string().min(1, 'project_id is required'),
      summary_text: z.string().min(1, 'summary_text is required'),
      job_id: z.string().optional(),
      ingestion_metrics: z.any().optional(),
      tags: z.any().optional()
    },
    outputSchema: {
      note_id: z.string(),
      project_id: z.string(),
      timestamp: z.string()
    }

• src/index.ts:634-696 (registration)

  The server.registerTool call that registers the 'coderswap_log_session_note' tool with the MCP server, providing the tool name, metadata/schemas, and handler function.

  server.registerTool(
    'coderswap_log_session_note',
    {
      title: 'Log Session Note',
      description: 'Record lightweight ingestion summary for session continuity (non-DSL)',
      inputSchema: {
        project_id: z.string().min(1, 'project_id is required'),
        summary_text: z.string().min(1, 'summary_text is required'),
        job_id: z.string().optional(),
        ingestion_metrics: z.any().optional(),
        tags: z.any().optional()
      },
      outputSchema: {
        note_id: z.string(),
        project_id: z.string(),
        timestamp: z.string()
      }
    },
    async ({ project_id, summary_text, job_id, ingestion_metrics, tags }) => {
      if (containsGuardrailBypass({ project_id, summary_text, job_id, ingestion_metrics, tags })) {
        return guardrailViolationResponse()
      }
      try {
        log('debug', 'Logging session note', { project_id, job_id })
  
        // Generate a simple note ID
        const timestamp = new Date().toISOString()
        const note_id = `note_${Date.now()}`
  
        // Log the note (for now, just to console/debug)
        log('info', `Session note logged for project ${project_id}`, {
          note_id,
          summary_text,
          job_id,
          ingestion_metrics,
          tags
        })
  
        const output = {
          note_id,
          project_id,
          timestamp
        }
  
        return {
          content: [{
            type: 'text',
            text: `✓ Logged session note: ${summary_text.substring(0, 100)}${summary_text.length > 100 ? '...' : ''}`
          }],
          structuredContent: output
        }
      } catch (error) {
        log('error', 'Failed to log session note', { project_id, error: error instanceof Error ? error.message : error })
        return {
          content: [{
            type: 'text',
            text: `✗ Failed to log session note: ${error instanceof Error ? error.message : 'Unknown error'}`
          }],
          isError: true
        }
      }
    }
  )