memo-mcp

Instructions

Implementation Reference

• src/repository/memos.ts:64-87 (handler)

  Core handler function that performs the memo search by filtering based on query, categoryId, and date range (start/end). Reads from DB and returns matching memos.

  export const searchMemos = async (params: SearchMemosParams) => {
    const { categoryId, end, query, start } = params
    await db.read()
  
    return db.data.memos.filter((memo) => {
      if (query && !memo.content.includes(query) && !memo.title.includes(query)) {
        return false
      }
  
      if (categoryId && memo.categoryId !== categoryId) {
        return false
      }
  
      const updatedAt = new Date(memo.updatedAt).getTime()
  
      if (start && updatedAt < start.getTime()) {
        return false
      }
      if (end && updatedAt > end.getTime()) {
        return false
      }
      return true
    })
  }

• src/schemas/memos.ts:42-69 (schema)

  Zod schema defining input parameters for searchMemos: optional categoryId, query, start/end dates with datetime parsing.

  export const SearchMemosSchema = z.object({
    categoryId: z.string().optional(),
    end: z
      .string()
      .datetime({
        message: "Invalid date format. Please use ISO 8601 format.",
        offset: true,
      })
      .transform((date) => new Date(date))
      .optional()
      .describe(
        "End date for the search range use ISO 8601 format. ex: 2020-02-01T00:00:00+09:00",
      ),
    query: z.string().optional(),
    start: z
      .string()
      .datetime({
        message: "Invalid date format. Please use ISO 8601 format.",
        offset: true,
      })
      .transform((date) => new Date(date))
      .optional()
      .describe(
        "Start date for the search range use ISO 8601 format. ex: 2020-01-01T00:00:00+09:00",
      ),
  })
  
  export type SearchMemosParams = z.infer<typeof SearchMemosSchema>

• src/server/tools.ts:142-157 (registration)

  Registers the searchMemos tool with the MCP server, specifying input/output schemas, description, and a thin handler that delegates to the repository function and formats the response.

  server.registerTool(
    "searchMemos",
    {
      description: "Search memos by keyword and date range",
      inputSchema: SearchMemosSchema.shape,
      outputSchema: { memos: z.array(MemoSchema) },
      title: "Search Memos",
    },
    async (params) => {
      const memos = await searchMemos(params)
      return {
        content: [{ text: JSON.stringify(memos), type: "text" }],
        structuredContent: { memos },
      }
    },
  )