Merge user & specification documentation#283
Merged
jspahrsummers merged 444 commits intomainfrom Apr 8, 2025
Merged
Conversation
…-lee/quickstart-updates
adding genaiscript client
…protocol/docs into zack-lee/quickstart-updates
…updates Phase 1 of documentation revamp: new Quickstart, servers, etc
…ementation to the top of the tutorial
Member
|
This is great. I love the new layout. One sidenote: Maybe we want to use https://mintlify.com/docs/navigation/versions in the longrun for the spec, but for now let's just get it merged? |
dsp-ant
approved these changes
Apr 8, 2025
Member
dsp-ant
left a comment
There was a problem hiding this comment.
Thank you so much for doing this!
Member
Author
This was referenced Apr 8, 2025
9 tasks
jonathanhefner
added a commit
to jonathanhefner/modelcontextprotocol
that referenced
this pull request
Jun 5, 2025
Most `*.md` files were converted to `*.mdx` in modelcontextprotocol#283, but `package.json` scripts and CI config were not updated to match. This commit makes the necessary updates. Unfortunately, Prettier currently only supports MDX v1 (see [prettier#15221][] and [prettier#12209][]), which causes it to treat content inside JSX tags as JSX instead of Markdown unless the content is surrounded by blank lines (see [prettier#16589][]). Therefore, this commit also adds blank lines inside JSX elements where necessary. This commit also removes the 89-character line wrap rule for `.md` files rather than update it for `.mdx` files. It's not clear that the rule was helpful, and we already have many files that do not abide by it: ```console $ grep -l '.{90}' docs/**/*.mdx | wc -l 59 ``` For ease of rebasing, this commit _does not_ actually format the files using Prettier. That will be done in the next commit. [prettier#15221]: prettier/prettier#15221 [prettier#12209]: prettier/prettier#12209 [prettier#16589]: prettier/prettier#16589
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 PR incorporates the contents of https://github.com/modelcontextprotocol/docs into this repo, so we have one source of truth for all "user" documentation as well as specification docs. I've included the other repo via a Git subtree, so as to not lose the contribution history.
The docs have been converted from Hugo/Hextra format into Mintlify MDX, as it has nicer rendering and comes with autogenerated https://modelcontextprotocol.io/llms-full.txt (very useful for LLMs helping with MCP stuff!).
Reading the diff will basically be impossible. Instead, see https://mcp-staging.mintlify.app/specification for the rendered version.
To do
After merging
Notify issues, PRs, etc. on the docs repo about the change(difficult to do in bulk)