Docs Updates #7 - MCP Server #686
Draft
bryantgillespie wants to merge 3 commits into
Draft
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
2592e27 to
9da3905
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
@nuxtjs/mcp-toolkitmodule and configured the MCP server to expose the documentation as a live tool for AI assistants, with a browser redirect to/mcp-helpfor human visitors. [1] [2] [3]/api/docsfor listing docs, searching, and fetching individual pages, each with rate limiting. [1] [2] [3]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:
CopyDocButton.vueto 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]agent-deeplinks.tsto support deep linking and MCP server URL generation.Documentation & Guides:
/content/mcp-help.mdas a user-facing guide and landing page for the docs MCP server, with instructions for connecting AI clients and IDEs.Build & Output Improvements:
content-markdown, to emit clean.mdversions of all docs pages for use by the MCP server and AI tools. [1] [2]Dependency & Configuration Updates:
@nuxtjs/mcp-toolkit,h3, andzod, and ensured proper overrides for compatibility. [1] [2] [3]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.