MCP Document Server

Implementation Reference

• tools/index.js:17-35 (handler)

  The main handler logic for the 'test_docs_path' tool. It attempts to list all .md files in the '../documents/' directory using the listMarkdownFiles helper, resolves the directory path, and returns a text content block with the results or an error message if the directory cannot be read.

  async () => {
    const baseDir = '../documents/';
    try {
      const files = await listMarkdownFiles(baseDir);
      return {
        content: [{ 
          type: "text", 
          text: `Directory path: ${path.resolve(baseDir)}\n\nFiles found:\n${files.join('\n')}` 
        }]
      };
    } catch (error) {
      return {
        content: [{ 
          type: "text", 
          text: `Error reading directory: ${error.message}\n\nAttempted path: ${path.resolve(baseDir)}` 
        }]
      };
    }
  }

• tools/index.js:16-16 (schema)

  Empty input schema for 'test_docs_path', indicating the tool takes no parameters.

  {},

• tools/index.js:15-36 (registration)

  Registration of the 'test_docs_path' tool within the registerTools function, specifying the name, schema, and handler.

  mcpServer.tool("test_docs_path",
    {},
    async () => {
      const baseDir = '../documents/';
      try {
        const files = await listMarkdownFiles(baseDir);
        return {
          content: [{ 
            type: "text", 
            text: `Directory path: ${path.resolve(baseDir)}\n\nFiles found:\n${files.join('\n')}` 
          }]
        };
      } catch (error) {
        return {
          content: [{ 
            type: "text", 
            text: `Error reading directory: ${error.message}\n\nAttempted path: ${path.resolve(baseDir)}` 
          }]
        };
      }
    }
  );

• utils/fileUtils.js:32-51 (helper)

  Helper function imported and used by the test_docs_path handler to list Markdown files (.md) in the specified base directory, filtering out dotfiles.

  export async function listMarkdownFiles(baseDir) {
      try {
        const dirents = await fs.readdir(baseDir, { withFileTypes: true });
        return dirents
          .filter(dirent => 
            dirent.isFile() && 
            dirent.name.toLowerCase().endsWith('.md') &&
            !dirent.name.startsWith('.')
          )
          .map(dirent => dirent.name);
      } catch (error) {
        if (error.code === 'ENOENT') {
          throw new FileSystemError('Directory not found', 'ENOENT');
        }
        if (error.code === 'EACCES') {
          throw new FileSystemError('Permission denied', 'EACCES');
        }
        throw new FileSystemError(`Error listing files: ${error.message}`, error.code);
      }
    }

• server.js:21-21 (registration)

  Invocation of registerTools which includes the registration of test_docs_path among other tools.

  registerTools(mcpServer);