MCP Notes

Instructions

Implementation Reference

• src/tools/index.ts:351-352 (registration)

  The "read_note" tool is registered here in the handleToolCall switch statement, delegating execution to the handleReadNote function.

  case "read_note":
    return await handleReadNote(notesPath, args);

• src/tools/index.ts:8-17 (handler)

  Imports the handleReadNote handler function from './filesystem.js', which contains the exact implementation of the read_note tool logic.

  import {
    ensureDirectory,
    initializeNotesDirectory,
    handleSearchFiles,
    handleReadNote,
    handleReadMultipleNotes,
    handleListDirectory,
    handleCreateDirectory,
    getFilesystemToolDefinitions
  } from './filesystem.js';

• src/tools/index.ts:8-17 (schema)

  Imports getFilesystemToolDefinitions from './filesystem.js', which provides the input schema and description for the read_note tool.

  import {
    ensureDirectory,
    initializeNotesDirectory,
    handleSearchFiles,
    handleReadNote,
    handleReadMultipleNotes,
    handleListDirectory,
    handleCreateDirectory,
    getFilesystemToolDefinitions
  } from './filesystem.js';

• src/notes/Note.ts:82-126 (helper)

  The Note.load() method provides the core file reading and frontmatter parsing logic, likely used within the handleReadNote implementation.

  async load(): Promise<boolean> {
    try {
      const content = await fs.readFile(this.fullPath, 'utf8');
      this.exists = true;
      
      // Parse frontmatter if it exists
      if (content.startsWith('---')) {
        const frontmatterEnd = content.indexOf('---', 3);
        if (frontmatterEnd !== -1) {
          const frontmatter = content.substring(3, frontmatterEnd);
          
          // Extract created date
          const createdMatch = frontmatter.match(/created: (.*)/);
          if (createdMatch) {
            const createdDate = new Date(createdMatch[1]);
            this.dateInfo = this._formatDate(createdDate);
          }
          
          // Extract tags
          const tagMatch = frontmatter.match(/tags:\n(?:  - .*\n)*/);
          if (tagMatch) {
            this.tags = tagMatch[0].split('\n')
              .slice(1) // Skip the "tags:" line
              .map(line => line.replace('  - ', ''))
              .filter(tag => tag); // Remove empty strings
          }
          
          // Store content without frontmatter
          this.content = content.substring(frontmatterEnd + 4);
        } else {
          this.content = content;
        }
      } else {
        this.content = content;
      }
      
      return true;
    } catch (error) {
      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
        this.exists = false;
        return false;
      }
      throw error;
    }
  }