mcp-structured-memory

Instructions

Implementation Reference

• src/tools/getFullMemory.ts:4-37 (handler)

  The handler function that executes the logic for the 'get_full_memory' tool. It reads the specified memory document from storage and returns its full content formatted as Markdown text with metadata.

  export async function getFullMemoryTool(
    storageManager: StorageManager,
    args: any
  ): Promise<any> {
    const params = args as GetFullMemoryParams;
  
    if (!params.memory_id) {
      throw new Error("Memory ID is required");
    }
  
    // Read the memory document
    const memory = await storageManager.readMemory(params.memory_id);
    if (!memory) {
      throw new Error(`Memory document with ID '${params.memory_id}' not found`);
    }
  
    return {
      content: [
        {
          type: "text",
          text: `# Full Memory: ${params.memory_id}
  
  **Created:** ${memory.metadata.created}
  **Updated:** ${memory.metadata.updated}
  **Status:** ${memory.metadata.status}
  **Tags:** ${memory.metadata.tags.join(", ") || "None"}
  
  ---
  
  ${memory.content}`,
        },
      ],
    };
  }

• src/types/memory.ts:83-85 (schema)

  TypeScript interface defining the input parameters for the get_full_memory tool.

  export interface GetFullMemoryParams {
    memory_id: string;
  }

• src/index.ts:238-247 (schema)

  JSON schema for the input parameters of the get_full_memory tool, as registered in the MCP server.

  inputSchema: {
    type: "object",
    properties: {
      memory_id: {
        type: "string",
        description: "The ID of the memory document to retrieve",
      },
    },
    required: ["memory_id"],
  },

• src/index.ts:234-248 (registration)

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

  {
    name: "get_full_memory",
    description:
      "Retrieve the complete content of a memory document with all Markdown formatting preserved (headings, **bold**, *italic*, `code`, [links](url), tables, lists, etc.)",
    inputSchema: {
      type: "object",
      properties: {
        memory_id: {
          type: "string",
          description: "The ID of the memory document to retrieve",
        },
      },
      required: ["memory_id"],
    },
  },

• src/index.ts:286-287 (registration)

  Dispatch case in the callTool handler that routes calls to the getFullMemoryTool function.

  case "get_full_memory":
    return await getFullMemoryTool(storageManager, args);