Skip to content

Commit 0695a49

Browse files
ihrprjerome3o-anthropicfelixweinbergerclaudedsp-ant
authored
* Initial refactor * draft concept for servers * remove unused * Remove ai generated content * fix navigation * header * clean up * updated * Initial refactor * Remove ai generated content * fix broken links * feat: create docs-v2 structure with diataxis framework - Create new docs-v2 directory with modern docs.json configuration - Implement 3-tab navigation: Overview, Documentation, Community - Structure Documentation section following diataxis framework: - Tutorials (learning-oriented) - Learn/Explanations (understanding-oriented) - How-to Guides (task-oriented) - Reference (information-oriented) - Add 44 stub files for team members to populate - Update package.json with docs-v2 scripts - Use modern docs.json format with proper tabs support 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * format * fix merge * fix * merge * fix * build new structure in existing docs folder * purge docs-v2 * update structure * create dummy structure * small rephrasing * change style to more technical * merge * simplify tool * format * structure * titles * add client concepts * apply suggested changes * format * apply suggested changes * Update architecture.mdx with comprehensive MCP overview Replace placeholder content with detailed documentation covering: - Core MCP concepts and scope - Participants (host, client, server) - Protocol layers (data and transport) - Lifecycle management, primitives, and notifications * Add comprehensive MCP protocol walkthrough to architecture docs Includes step-by-step examples of initialization, tool discovery, execution, and real-time notifications with detailed JSON-RPC message exchanges. Co-Authored-By: Assistant <[email protected]> * Improvements * Improve MCP architecture documentation clarity and structure - Fix typos and grammar issues throughout the document - Add clearer explanations for MCP primitives and their use cases - Restructure content for better readability and flow - Enhance descriptions of client-exposed primitives with practical examples 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * MCP protocol -> MCP * Add SDK documentation page - Create comprehensive SDK documentation listing all official MCP SDKs - Include TypeScript, Python, Java, Kotlin, C#, and Ruby SDKs - Link to package registries and GitHub repositories - Credit maintainers for each SDK 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * fixup * Update docs/docs/learn/architecture.mdx Co-authored-by: Inna Harper <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update docs/docs/learn/architecture.mdx Co-authored-by: Jonathan Hefner <[email protected]> * Update architecture documentation - Clarify that reference implementations are specifically for servers - Simplify data/transport layer explanation by removing Info component - Update client features description for clarity 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * prettier * non code example * fix broken links * apply suggested changes * small fixed * clean up * move lern after Getting Started * Fix broken anchor links * Remove reference to nonexistent section While there is a "Transport Layer" section (which is linked in a prior bullet point), there is no section for an overview of the transport protocol. * getting started intro * Fix typos * Shorten introduction in architecture overview The automatically-generated table of contents will provide links to individual sections, so the introduction need not do so comprehensively. Instead, the introduction can just link to a few key sections. * fix slyles after merge * remove reference * community tab * use mcp * use remote mcp * use local mcp server * link old pages * update names for server and client * sdks page * add missing SDKs * remove discord - communications page will be used * initial landing page * remove get started from landing page * improve landing page * more changes to index * CI * CI * CI * CI * broken links * CI * fix oops * docs: improve architecture documentation clarity Enhance readability of MCP architecture docs by: - Simplifying client-server relationship explanation - Adding visual mermaid diagram to illustrate connections - Clarifying server vs client features descriptions - Converting Note block to inline text for better flow - Fixing SDK reference link 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * address theos feedback * server contepts feedback * client concepts feedback * sdks comments * intro feedback * remote server * user page feednacl * CI * suggestes changes from basil * format * documentation as a first tab * Remove protocol from specification tab * bring back schema reference * documentation page structure * fix broken links * reorganize documentation * fix broken SDKs link * move faq and remove how to * server and client examples * back to old structure in documents * remove mcp logo on landing page * format * remove video (will be added back soon) * fix AI-powered to AI-enable * Add inverted logo to overview page with two-column layout - Added logo2.jpg to the overview page - Created two-column layout with text on left, logo on right - Applied invert filter to flip logo colors from white-on-black to black-on-white - Added rounded corners to logo image 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * Reorganize overview page with MCP logo sidebar layout Place "Connect your AI applications" content on left with MCP logo on right. Ensure consistent section widths across the page for better visual alignment. Add responsive design for mobile screens. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]> * remove logos * remove hiding of the overview --------- Co-authored-by: Jerome <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> Co-authored-by: Claude <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> Co-authored-by: David Soria Parra <[email protected]> Co-authored-by: David Soria Parra <[email protected]> Co-authored-by: Jonathan Hefner <[email protected]>
1 parent ef4af78 commit 0695a49

33 files changed

+2111
-454
lines changed

docs/docs.json

Lines changed: 51 additions & 280 deletions
Original file line numberDiff line numberDiff line change
@@ -21,52 +21,58 @@
2121
]
2222
},
2323
"navigation": {
24-
"versions": [
24+
"tabs": [
2525
{
26-
"version": "Version 2025-06-18 (latest)",
27-
"groups": [
26+
"tab": "Overview",
27+
"pages": ["overview/index"]
28+
},
29+
{
30+
"tab": "Documentation",
31+
"pages": [
32+
"docs/getting-started/intro",
33+
"docs/sdk",
34+
{
35+
"group": "Concepts",
36+
"pages": [
37+
"docs/learn/architecture",
38+
"docs/learn/server-concepts",
39+
"docs/learn/client-concepts",
40+
"specification/versioning"
41+
]
42+
},
2843
{
29-
"group": "User Guide",
44+
"group": "Tutorials",
3045
"pages": [
31-
"introduction",
3246
{
33-
"group": "Quickstart",
47+
"group": "Using MCP",
3448
"pages": [
35-
"quickstart/server",
36-
"quickstart/client",
49+
"docs/tutorials/use-remote-mcp-server",
3750
"quickstart/user"
3851
]
3952
},
4053
{
41-
"group": "Concepts",
54+
"group": "Server Development",
4255
"pages": [
43-
"docs/concepts/architecture",
44-
"docs/concepts/resources",
45-
"docs/concepts/prompts",
46-
"docs/concepts/tools",
47-
"docs/concepts/sampling",
48-
"docs/concepts/roots",
49-
"docs/concepts/elicitation",
50-
"docs/concepts/transports"
56+
"quickstart/server",
57+
"legacy/tools/inspector"
5158
]
5259
},
5360
{
54-
"group": "Examples",
55-
"pages": ["examples", "clients"]
56-
},
57-
{
58-
"group": "Tutorials",
61+
"group": "Client Development",
5962
"pages": [
60-
"tutorials/building-mcp-with-llms",
61-
"docs/tools/debugging",
62-
"docs/tools/inspector"
63+
"quickstart/client"
6364
]
64-
},
65-
"faqs"
65+
}
6666
]
6767
},
68+
"faqs"
69+
]
70+
},
71+
{
72+
"tab": "Specification",
73+
"versions": [
6874
{
69-
"group": "Protocol",
75+
"version": "Version 2025-06-18 (latest)",
7076
"pages": [
7177
"specification/2025-06-18/index",
7278
"specification/2025-06-18/changelog",
@@ -118,80 +124,7 @@
118124
]
119125
},
120126
{
121-
"group": "Community",
122-
"pages": [
123-
"community/governance",
124-
"community/sep-guidelines"
125-
]
126-
},
127-
{
128-
"group": "Development",
129-
"pages": [
130-
"specification/versioning",
131-
"development/roadmap",
132-
"development/contributing"
133-
]
134-
},
135-
{
136-
"group": "SDKs",
137-
"pages": [
138-
"links/sdks/csharp",
139-
"links/sdks/go",
140-
"links/sdks/java",
141-
"links/sdks/kotlin",
142-
"links/sdks/python",
143-
"links/sdks/ruby",
144-
"links/sdks/rust",
145-
"links/sdks/swift",
146-
"links/sdks/typescript"
147-
]
148-
}
149-
]
150-
},
151-
{
152-
"version": "Version 2025-03-26",
153-
"groups": [
154-
{
155-
"group": "User Guide",
156-
"pages": [
157-
"introduction",
158-
{
159-
"group": "Quickstart",
160-
"pages": [
161-
"quickstart/server",
162-
"quickstart/client",
163-
"quickstart/user"
164-
]
165-
},
166-
{
167-
"group": "Concepts",
168-
"pages": [
169-
"docs/concepts/architecture",
170-
"docs/concepts/resources",
171-
"docs/concepts/prompts",
172-
"docs/concepts/tools",
173-
"docs/concepts/sampling",
174-
"docs/concepts/roots",
175-
"docs/concepts/transports"
176-
]
177-
},
178-
{
179-
"group": "Examples",
180-
"pages": ["examples", "clients"]
181-
},
182-
{
183-
"group": "Tutorials",
184-
"pages": [
185-
"tutorials/building-mcp-with-llms",
186-
"docs/tools/debugging",
187-
"docs/tools/inspector"
188-
]
189-
},
190-
"faqs"
191-
]
192-
},
193-
{
194-
"group": "Protocol",
127+
"version": "Version 2025-03-26",
195128
"pages": [
196129
"specification/2025-03-26/index",
197130
"specification/2025-03-26/changelog",
@@ -236,84 +169,12 @@
236169
]
237170
}
238171
]
239-
}
240-
]
241-
},
242-
{
243-
"group": "Community",
244-
"pages": [
245-
"community/governance",
246-
"community/sep-guidelines"
247-
]
248-
},
249-
{
250-
"group": "Development",
251-
"pages": [
252-
"specification/versioning",
253-
"development/roadmap",
254-
"development/contributing"
255-
]
256-
},
257-
{
258-
"group": "SDKs",
259-
"pages": [
260-
"links/sdks/csharp",
261-
"links/sdks/go",
262-
"links/sdks/java",
263-
"links/sdks/kotlin",
264-
"links/sdks/python",
265-
"links/sdks/ruby",
266-
"links/sdks/rust",
267-
"links/sdks/swift",
268-
"links/sdks/typescript"
269-
]
270-
}
271-
]
272-
},
273-
{
274-
"version": "Version 2024-11-05",
275-
"groups": [
276-
{
277-
"group": "User Guide",
278-
"pages": [
279-
"introduction",
280-
{
281-
"group": "Quickstart",
282-
"pages": [
283-
"quickstart/server",
284-
"quickstart/client",
285-
"quickstart/user"
286-
]
287-
},
288-
{
289-
"group": "Concepts",
290-
"pages": [
291-
"docs/concepts/architecture",
292-
"docs/concepts/resources",
293-
"docs/concepts/prompts",
294-
"docs/concepts/tools",
295-
"docs/concepts/sampling",
296-
"docs/concepts/roots",
297-
"docs/concepts/transports"
298-
]
299-
},
300-
{
301-
"group": "Examples",
302-
"pages": ["examples", "clients"]
303-
},
304-
{
305-
"group": "Tutorials",
306-
"pages": [
307-
"tutorials/building-mcp-with-llms",
308-
"docs/tools/debugging",
309-
"docs/tools/inspector"
310-
]
311172
},
312-
"faqs"
173+
"specification/2025-03-26/schema"
313174
]
314175
},
315176
{
316-
"group": "Protocol",
177+
"version": "Version 2024-11-05",
317178
"pages": [
318179
"specification/2024-11-05/index",
319180
"specification/2024-11-05/architecture/index",
@@ -357,84 +218,12 @@
357218
]
358219
}
359220
]
360-
}
361-
]
362-
},
363-
{
364-
"group": "Community",
365-
"pages": [
366-
"community/governance",
367-
"community/sep-guidelines"
368-
]
369-
},
370-
{
371-
"group": "Development",
372-
"pages": [
373-
"specification/versioning",
374-
"development/roadmap",
375-
"development/contributing"
376-
]
377-
},
378-
{
379-
"group": "SDKs",
380-
"pages": [
381-
"links/sdks/csharp",
382-
"links/sdks/go",
383-
"links/sdks/java",
384-
"links/sdks/kotlin",
385-
"links/sdks/python",
386-
"links/sdks/ruby",
387-
"links/sdks/rust",
388-
"links/sdks/swift",
389-
"links/sdks/typescript"
390-
]
391-
}
392-
]
393-
},
394-
{
395-
"version": "Draft",
396-
"groups": [
397-
{
398-
"group": "User Guide",
399-
"pages": [
400-
"introduction",
401-
{
402-
"group": "Quickstart",
403-
"pages": [
404-
"quickstart/server",
405-
"quickstart/client",
406-
"quickstart/user"
407-
]
408221
},
409-
{
410-
"group": "Concepts",
411-
"pages": [
412-
"docs/concepts/architecture",
413-
"docs/concepts/resources",
414-
"docs/concepts/prompts",
415-
"docs/concepts/tools",
416-
"docs/concepts/sampling",
417-
"docs/concepts/roots",
418-
"docs/concepts/transports"
419-
]
420-
},
421-
{
422-
"group": "Examples",
423-
"pages": ["examples", "clients"]
424-
},
425-
{
426-
"group": "Tutorials",
427-
"pages": [
428-
"tutorials/building-mcp-with-llms",
429-
"docs/tools/debugging",
430-
"docs/tools/inspector"
431-
]
432-
},
433-
"faqs"
222+
"specification/2024-11-05/schema"
434223
]
435224
},
436225
{
437-
"group": "Protocol",
226+
"version": "Draft",
438227
"pages": [
439228
"specification/draft/index",
440229
"specification/draft/changelog",
@@ -484,37 +273,19 @@
484273
},
485274
"specification/draft/schema"
486275
]
487-
},
488-
{
489-
"group": "Community",
490-
"pages": [
491-
"community/governance",
492-
"community/sep-guidelines"
493-
]
494-
},
495-
{
496-
"group": "Development",
497-
"pages": [
498-
"specification/versioning",
499-
"development/roadmap",
500-
"development/contributing"
501-
]
502-
},
503-
{
504-
"group": "SDKs",
505-
"pages": [
506-
"links/sdks/csharp",
507-
"links/sdks/go",
508-
"links/sdks/java",
509-
"links/sdks/kotlin",
510-
"links/sdks/python",
511-
"links/sdks/ruby",
512-
"links/sdks/rust",
513-
"links/sdks/swift",
514-
"links/sdks/typescript"
515-
]
516276
}
517277
]
278+
},
279+
{
280+
"tab": "Community",
281+
"pages": [
282+
"community/governance",
283+
"community/sep-guidelines",
284+
"development/roadmap",
285+
"development/contributing",
286+
"clients",
287+
"examples"
288+
]
518289
}
519290
]
520291
},
@@ -551,4 +322,4 @@
551322
"contextual": {
552323
"options": ["copy", "view"]
553324
}
554-
}
325+
}

0 commit comments

Comments
 (0)