Skip to content

Docs Updates #7 - MCP Server #686

Draft
bryantgillespie wants to merge 3 commits into
bry/dockem-6-typesense-searchfrom
bry/dockem-7-mcp-tools
Draft

Docs Updates #7 - MCP Server #686
bryantgillespie wants to merge 3 commits into
bry/dockem-6-typesense-searchfrom
bry/dockem-7-mcp-tools

Conversation

@bryantgillespie
Copy link
Copy Markdown
Member

@bryantgillespie bryantgillespie commented May 26, 2026

This pull request introduces a comprehensive integration of the Model Context Protocol (MCP) server into the Directus documentation site, enabling AI assistants and IDEs to natively search, read, and interact with the docs. It adds new endpoints, UI enhancements, and supporting utilities for seamless AI and IDE integration, along with supporting documentation and build improvements.

MCP Server Integration & API Endpoints:

  • Added the @nuxtjs/mcp-toolkit module and configured the MCP server to expose the documentation as a live tool for AI assistants, with a browser redirect to /mcp-help for human visitors. [1] [2] [3]
  • Implemented public API endpoints under /api/docs for listing docs, searching, and fetching individual pages, each with rate limiting. [1] [2] [3]
  • Added a new MCP tool, get-directus-file, to securely fetch file contents from allowlisted Directus GitHub repositories, with chunking and sensitive path protection.

UI Enhancements for AI/IDE Integration:

  • Upgraded CopyDocButton.vue to provide one-click actions for copying Markdown links, opening pages in ChatGPT or Claude, and copying the MCP server URL. Also added quick links for installing the docs MCP server in Cursor and VS Code. [1] [2] [3]
  • Added utility functions and IDE option definitions in agent-deeplinks.ts to support deep linking and MCP server URL generation.

Documentation & Guides:

  • Added /content/mcp-help.md as a user-facing guide and landing page for the docs MCP server, with instructions for connecting AI clients and IDEs.
  • Updated the MCP guide and navigation for clarity.

Build & Output Improvements:

  • Introduced a custom Nuxt module, content-markdown, to emit clean .md versions of all docs pages for use by the MCP server and AI tools. [1] [2]

Dependency & Configuration Updates:

  • Added new dependencies: @nuxtjs/mcp-toolkit, h3, and zod, and ensured proper overrides for compatibility. [1] [2] [3]
  • Enabled Nuxt async context and updated configuration for optimal MCP and prerendering support.

These changes collectively make the Directus documentation site a first-class MCP server, enabling advanced AI and IDE integrations while maintaining security and ease of use.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 26, 2026 8:17pm

Request Review

@bryantgillespie bryantgillespie changed the base branch from main to bry/dockem-6-typesense-search May 26, 2026 20:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant