Deep Code Reasoning MCP Server

Instructions

Implementation Reference

• src/analyzers/DeepCodeReasonerV2.ts:507-539 (handler)

  Core handler function that retrieves conversation session status from ConversationManager, computes progress and finalization readiness, returns structured status object or 'not_found' if session missing.

  async getConversationStatus(
    sessionId: string,
  ): Promise<{
    sessionId: string;
    status: string;
    turnCount: number;
    lastActivity: number;
    progress: number;
    canFinalize: boolean;
  }> {
    const session = this.conversationManager.getSession(sessionId);
    if (!session) {
      return {
        sessionId,
        status: 'not_found',
        turnCount: 0,
        lastActivity: 0,
        progress: 0,
        canFinalize: false,
      };
    }
  
    const canFinalize = this.conversationManager.shouldComplete(sessionId);
  
    return {
      sessionId,
      status: session.status,
      turnCount: session.turns.length,
      lastActivity: session.lastActivity,
      progress: session.analysisProgress.confidenceLevel,
      canFinalize,
    };
  }

• src/index.ts:123-125 (schema)

  Zod schema for validating input parameters (session_id) of the get_conversation_status tool.

  const GetConversationStatusSchema = z.object({
    session_id: z.string(),
  });

• src/index.ts:404-416 (registration)

  Tool registration in the ListTools response, defining name, description, and input schema for MCP tool discovery.

    name: 'get_conversation_status',
    description: 'Check the status and progress of an ongoing conversation',
    inputSchema: {
      type: 'object',
      properties: {
        session_id: {
          type: 'string',
          description: 'ID of the conversation session',
        },
      },
      required: ['session_id'],
    },
  },

• src/index.ts:714-728 (handler)

  MCP CallToolRequest handler case: parses args with schema, delegates to DeepCodeReasonerV2.getConversationStatus, formats result as MCP response.

  case 'get_conversation_status': {
    const parsed = GetConversationStatusSchema.parse(args);
    const result = await deepReasoner.getConversationStatus(
      parsed.session_id,
    );
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }