@mastra/mcp-docs-server 0.0.3 → 0.0.4-alpha.1

package/dist/tools/docs.js

@@ -1,176 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { z } from 'zod';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const docsBaseDir = path.join(__dirname, '../../.docs/raw/');
-// Helper function to list contents of a directory
-async function listDirContents(dirPath) {
-    const entries = await fs.readdir(dirPath, { withFileTypes: true });
-    const dirs = [];
-    const files = [];
-    for (const entry of entries) {
-        if (entry.isDirectory()) {
-            dirs.push(entry.name + '/');
-        }
-        else if (entry.isFile() && entry.name.endsWith('.mdx')) {
-            files.push(entry.name);
-        }
-    }
-    return {
-        dirs: dirs.sort(),
-        files: files.sort(),
-    };
-}
-// Helper function to read MDX files from a path
-async function readMdxContent(docPath) {
-    const fullPath = path.join(docsBaseDir, docPath);
-    // Check if path exists
-    try {
-        const stats = await fs.stat(fullPath);
-        if (stats.isDirectory()) {
-            const { dirs, files } = await listDirContents(fullPath);
-            const dirListing = [
-                `Directory contents of ${docPath}:`,
-                '',
-                dirs.length > 0 ? 'Subdirectories:' : 'No subdirectories.',
-                ...dirs.map(d => `- ${d}`),
-                '',
-                files.length > 0 ? 'Files in this directory:' : 'No files in this directory.',
-                ...files.map(f => `- ${f}`),
-                '',
-                '---',
-                '',
-                'Contents of all files in this directory:',
-                '',
-            ].join('\n');
-            // Append all file contents
-            let fileContents = '';
-            for (const file of files) {
-                const filePath = path.join(fullPath, file);
-                const content = await fs.readFile(filePath, 'utf-8');
-                fileContents += `\n\n# ${file}\n\n${content}`;
-            }
-            return dirListing + fileContents;
-        }
-        // If it's a file, just read it
-        return fs.readFile(fullPath, 'utf-8');
-    }
-    catch (error) {
-        throw new Error(`Path not found: ${docPath}`);
-    }
-}
-// Helper function to find nearest existing directory and its contents
-async function findNearestDirectory(docPath, availablePaths) {
-    // Split path into parts and try each parent directory
-    const parts = docPath.split('/');
-    while (parts.length > 0) {
-        const testPath = parts.join('/');
-        try {
-            const fullPath = path.join(docsBaseDir, testPath);
-            const stats = await fs.stat(fullPath);
-            if (stats.isDirectory()) {
-                const { dirs, files } = await listDirContents(fullPath);
-                return [
-                    `Path "${docPath}" not found.`,
-                    `Here are the available paths in "${testPath}":`,
-                    '',
-                    dirs.length > 0 ? 'Directories:' : 'No subdirectories.',
-                    ...dirs.map(d => `- ${testPath}/${d}`),
-                    '',
-                    files.length > 0 ? 'Files:' : 'No files.',
-                    ...files.map(f => `- ${testPath}/${f}`),
-                ].join('\n');
-            }
-        }
-        catch {
-            // Directory doesn't exist, try parent
-        }
-        parts.pop();
-    }
-    // If no parent directories found, return root listing
-    return [`Path "${docPath}" not found.`, 'Here are all available paths:', '', availablePaths].join('\n');
-}
-// Get initial directory listing for the description
-async function getAvailablePaths() {
-    const { dirs, files } = await listDirContents(docsBaseDir);
-    // Get reference directory contents if it exists
-    let referenceDirs = [];
-    if (dirs.includes('reference/')) {
-        const { dirs: refDirs } = await listDirContents(path.join(docsBaseDir, 'reference'));
-        referenceDirs = refDirs.map(d => `reference/${d}`);
-    }
-    return [
-        'Available top-level paths:',
-        '',
-        'Directories:',
-        ...dirs.map(d => `- ${d}`),
-        '',
-        referenceDirs.length > 0 ? 'Reference subdirectories:' : '',
-        ...referenceDirs.map(d => `- ${d}`),
-        '',
-        'Files:',
-        ...files.map(f => `- ${f}`),
-    ]
-        .filter(Boolean)
-        .join('\n');
-}
-// Initialize available paths
-const availablePaths = await getAvailablePaths();
-const docsSchema = z.object({
-    paths: z
-        .array(z.string())
-        .min(1)
-        .describe(`One or more documentation paths to fetch\nAvailable paths:\n${availablePaths}`),
-});
-export const docsTool = {
-    name: 'mastraDocs',
-    description: 'Get Mastra.ai documentation. Request paths to explore the docs. References contain API docs. Other paths contain guides. The user doesn\'t know about files and directories. This is your internal knowledge the user can\'t read. If the user asks about a feature check general docs as well as reference docs for that feature. Ex: with evals check in evals/ and in reference/evals/. Provide code examples so the user understands. If you build a URL from the path, only paths ending in .mdx exist. Note that docs about MCP are currently in reference/tools/. IMPORTANT: Be concise with your answers. The user will ask for more info. If packages need to be installed, provide the pnpm command to install them. Ex. if you see `import { X } from "@mastra/$PACKAGE_NAME"` in an example, show an install command. Always install latest tag, not alpha unless requested. If you scaffold a new project it may be in a subdir',
-    parameters: docsSchema,
-    execute: async (args, _context) => {
-        try {
-            const results = await Promise.all(args.paths.map(async (path) => {
-                try {
-                    const content = await readMdxContent(path);
-                    return {
-                        path,
-                        content,
-                        error: null,
-                    };
-                }
-                catch (error) {
-                    if (error instanceof Error && error.message.includes('Path not found')) {
-                        const suggestions = await findNearestDirectory(path, availablePaths);
-                        return {
-                            path,
-                            content: null,
-                            error: suggestions,
-                        };
-                    }
-                    return {
-                        path,
-                        content: null,
-                        error: error instanceof Error ? error.message : 'Unknown error',
-                    };
-                }
-            }));
-            // Format the results
-            const output = results
-                .map(result => {
-                if (result.error) {
-                    return `## ${result.path}\n\n${result.error}\n\n---\n`;
-                }
-                return `## ${result.path}\n\n${result.content}\n\n---\n`;
-            })
-                .join('\n');
-            return output;
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                throw new Error(`Failed to fetch documentation: ${error.message}`);
-            }
-            throw error;
-        }
-    },
-};

package/dist/tools/examples.d.ts

@@ -1,11 +0,0 @@
-import type { Tool } from 'tylerbarnes-fastmcp-fix';
-import { z } from 'zod';
-declare const examplesSchema: z.ZodObject<{
-    example: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    example?: string | undefined;
-}, {
-    example?: string | undefined;
-}>;
-export declare const examplesTool: Tool<any, typeof examplesSchema>;
-export {};

package/dist/tools/examples.js

@@ -1,61 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { z } from 'zod';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-// Helper function to list code examples
-async function listCodeExamples() {
-    const examplesDir = path.resolve(__dirname, '../../.docs/organized/code-examples');
-    try {
-        const files = await fs.readdir(examplesDir);
-        return files
-            .filter(f => f.endsWith('.md'))
-            .map(f => ({
-            name: f.replace('.md', ''),
-            path: f,
-        }))
-            .sort((a, b) => a.name.localeCompare(b.name));
-    }
-    catch {
-        return [];
-    }
-}
-// Helper function to read a code example
-async function readCodeExample(filename) {
-    const examplesDir = path.resolve(__dirname, '../../.docs/organized/code-examples');
-    const filePath = path.join(examplesDir, filename);
-    try {
-        return await fs.readFile(filePath, 'utf-8');
-    }
-    catch {
-        const examples = await listCodeExamples();
-        const availableExamples = examples.map(ex => `- ${ex.name}`).join('\n');
-        throw new Error(`Example "${filename}" not found.\n\nAvailable examples:\n${availableExamples}`);
-    }
-}
-// Get initial examples for the description
-const initialExamples = await listCodeExamples();
-const examplesListing = initialExamples.length > 0
-    ? '\n\nAvailable examples: ' + initialExamples.map(ex => ex.name).join(', ')
-    : '\n\nNo examples available yet. Run the documentation preparation script first.';
-const examplesSchema = z.object({
-    example: z
-        .string()
-        .optional()
-        .describe('Name of the specific example to fetch. If not provided, lists all available examples.' + examplesListing),
-});
-export const examplesTool = {
-    name: 'mastraExamples',
-    description: 'Get code examples from the Mastra.ai examples directory. Without a specific example name, lists all available examples. With an example name, returns the full source code of that example.',
-    parameters: examplesSchema,
-    execute: async (args, _context) => {
-        if (!args.example) {
-            const examples = await listCodeExamples();
-            return ['Available code examples:', '', ...examples.map(ex => `- ${ex.name}`)].join('\n');
-        }
-        const filename = args.example.endsWith('.md') ? args.example : `${args.example}.md`;
-        const content = await readCodeExample(filename);
-        return content;
-    },
-};

package/dist/utils.d.ts

@@ -1,6 +0,0 @@
-export declare function fromRepoRoot(relative: string): string;
-export declare function fromPackageRoot(relative: string): string;
-export declare const log: {
-    (...data: any[]): void;
-    (message?: any, ...optionalParams: any[]): void;
-};

package/dist/utils.js

@@ -1,9 +0,0 @@
-import path from 'path';
-export function fromRepoRoot(relative) {
-    return path.resolve(import.meta.dirname, `../../../`, relative);
-}
-export function fromPackageRoot(relative) {
-    return path.resolve(import.meta.dirname, `../`, relative);
-}
-// can't use console.log() because it writes to stdout which will interfere with the MCP Stdio protocol
-export const log = console.error;