anuna-research/cbcl-modelcontextprotocol
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions
fork of modelcontextprotocol
1,715 commits 1 branch 0 tags 20 MiB
  • TypeScript 95.8%
  • JavaScript 4%
  • CSS 0.1%
Find a file
Exact
Inna Harper 0695a497eb
 Docs redesign (#1044) 
* 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 <noreply@anthropic.com>

* 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 <noreply@anthropic.com>

* 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 <noreply@anthropic.com>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* 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 <noreply@anthropic.com>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* fixup

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Inna Harper <inna.hrpr@gmail.com>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* Update docs/docs/learn/architecture.mdx

Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>

* 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 <noreply@anthropic.com>

* 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 <noreply@anthropic.com>

* 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 <noreply@anthropic.com>

* 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 <noreply@anthropic.com>

* remove logos

* remove hiding of the overview

---------

Co-authored-by: Jerome <jerome@anthropic.com>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>
Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com>
Co-authored-by: David Soria Parra <davidsp@anthropic.com>
Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
2025-07-25 18:58:42 +01:00
.github Update codeowners of docs to @modelcontextprotocol/docs-maintaners group (#1042) 2025-07-23 10:25:33 +01:00
blog [blog] Governance for MCP (#989) 2025-07-17 20:53:15 +01:00
docs Docs redesign (#1044) 2025-07-25 18:58:42 +01:00
schema Add schema reference page for version 2025-06-18 2025-07-14 11:18:33 -05:00
.gitattributes Add schema reference page 2025-07-14 10:34:50 -05:00
.gitignore add .DS_Store to gitignore 2025-01-03 21:13:32 +00:00
.npmrc Add .npmrc 2024-10-31 21:47:42 +00:00
.nvmrc Initial import 2024-09-24 21:41:22 +01:00
.prettierignore Add schema reference page 2025-07-14 10:34:50 -05:00
CODE_OF_CONDUCT.md chore: add markdown format check workflow and format all docs 2025-01-20 18:34:04 +00:00
CONTRIBUTING.md Add schema reference page 2025-07-14 10:34:50 -05:00
LICENSE Claude migration of spec to Mintlify docs 2025-04-07 16:32:50 +01:00
MAINTAINERS.md (chore) Create MAINTAINERS.md (#1001) 2025-07-24 09:51:09 +01:00
package-lock.json Update mintlify dependency 2025-07-22 10:02:49 -05:00
package.json Update mintlify dependency 2025-07-22 10:02:49 -05:00
README.md docs: Fix typos 2025-06-30 11:52:16 -07:00
SECURITY.md chore: add markdown format check workflow and format all docs 2025-01-20 18:34:04 +00:00
tsconfig.json Add tsconfig to fix validate:schema, remove unused script 2025-04-07 17:29:50 +01:00
typedoc.config.mjs Add schema reference page 2025-07-14 10:34:50 -05:00
typedoc.plugin.mjs Add schema reference page 2025-07-14 10:34:50 -05:00

README.md

Model Context Protocol specification

This repo contains the specification and protocol schema for the Model Context Protocol.

The schema is defined in TypeScript first, but made available as JSON Schema as well, for wider compatibility.

The official MCP documentation is built using Mintlify and available at modelcontextprotocol.io.

Contributing

Please see CONTRIBUTING.md for details on how to contribute to this project.

License

This project is licensed under the MIT License—see the LICENSE file for details.