reference-drive
Access detailed documentation for Turbo Drive API methods, configuration options, and programmatic navigation control via the Turbo Docs MCP Server, integrated with Claude Desktop and VS Code.
Instructions
Turbo Drive API reference - detailed documentation of Drive methods, configuration options, and programmatic control of navigation behavior
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:16-45 (registration)Registers the 'reference-drive' tool (among others from config) using server.tool with name from config, description from config, and an inline async handler that fetches the content of 'reference/drive.md' using readMarkdownFile and returns it as a text content block, or error message if failed.// Register a tool for each documentation file docFiles.forEach(({ folder, file, name, description }) => { server.tool( name, description, async () => { try { const content = await readMarkdownFile(path.join(folder, file)); return { content: [ { type: "text", text: content } ] }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [ { type: "text", text: `Error reading ${file}: ${errorMessage}` } ] }; } } ); });
- src/index.ts:21-44 (handler)Inline handler function for the 'reference-drive' tool: reads the specific markdown file using readMarkdownFile, returns its content as MCP text block, handles errors.async () => { try { const content = await readMarkdownFile(path.join(folder, file)); return { content: [ { type: "text", text: content } ] }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [ { type: "text", text: `Error reading ${file}: ${errorMessage}` } ] }; } } );
- src/config.ts:70-74 (helper)Configuration object defining the parameters for the 'reference-drive' tool: specifies folder 'reference', file 'drive.md', tool name, and description used in registration.{ folder: 'reference', file: 'drive.md', name: 'reference-drive', description: 'Turbo Drive API reference - detailed documentation of Drive methods, configuration options, and programmatic control of navigation behavior'
- src/documentReader.ts:14-61 (helper)Core helper function readMarkdownFile used by the tool handler to fetch 'reference/drive.md' content from cache, GitHub raw, or local fallback.export async function readMarkdownFile(filename: string): Promise<string> { const filePath = path.join(docsFolder, filename); if (!filePath.startsWith(docsFolder)) { throw new Error("Invalid file path"); } // Get current commit info if we don't have it yet if (!mainBranchInfo) { try { const commitInfo = await fetchMainBranchInformation(); const cacheKey = `${commitInfo.sha.substring(0, 7)}-${commitInfo.timestamp}`; mainBranchInfo = { ...commitInfo, cacheKey }; } catch (shaError) { console.error('Failed to get GitHub commit info, falling back to direct fetch'); } } // Try to read from cache first if we have commit info if (mainBranchInfo) { const cachedFilePath = path.join(cacheFolder, mainBranchInfo.cacheKey, filename); try { const content = await fs.promises.readFile(cachedFilePath, "utf-8"); console.error(`Using cached content for ${mainBranchInfo.cacheKey}: ${filename}`); return content; } catch (cacheError) { // Cache miss, continue to fetch from GitHub } } // Fetch from GitHub try { return await fetchFromGitHub(filename, mainBranchInfo?.cacheKey); } catch (githubError) { console.error(`GitHub fetch failed: ${githubError}, attempting to read from local files...`); // Fallback: read from local files try { return await fs.promises.readFile(filePath, "utf-8"); } catch (localError) { const githubErrorMessage = githubError instanceof Error ? githubError.message : String(githubError); const localErrorMessage = localError instanceof Error ? localError.message : String(localError); throw new Error(`Failed to read file from GitHub (${githubErrorMessage}) and locally (${localErrorMessage})`); } } }