modelcontextprotocol

This repository provides the Model Context Protocol (MCP) specification, protocol schema, and official documentation. It does not appear to include a runnable MCP server out of the box. Instead, you can study the TypeScript-based MCP schema (schema/2025-11-25/schema.ts) and the published JSON Schema (schema/2025-11-25/schema.json) to understand how MCP messages are structured, what capabilities exist, and how contexts and messages should be modeled. The official documentation is hosted at modelcontextprotocol.io, which is linked from this repo, and serves as a practical guide for implementing MCP clients and servers. If you’re implementing an MCP server, use this repository as a reference for the protocols, schemas, and data models your server must support, and align your implementation with the definitions in these files.

Prerequisites: a development environment with Git and a runtime capable of handling the tooling you plan to use (for example, Node.js for TypeScript sources or a Python/UV setup if you convert the specs to another runtime).

Steps:

1. Clone the repository: git clone https://github.com/modelcontextprotocol/modelcontextprotocol-modelcontextprotocol.git cd modelcontextprotocol-modelcontextprotocol

2. Inspect the repository contents to locate the MCP schema and docs:

   • Schema (TypeScript): schema/2025-11-25/schema.ts
   • JSON Schema: schema/2025-11-25/schema.json
   • Documentation: the website linked in the README (modelcontextprotocol.io)

3. If you plan to work with the TypeScript sources, ensure you have Node.js installed. Install any local dependencies if a package.json is present (the README does not indicate a runnable server package here, but you may have tooling for development): npm install

4. If you want to convert or validate schemas against JSON Schema tooling, install a JSON Schema validator/processor of your choice and reference schema.json:

   • Example (Node.js): npx ajv compile schema/2025-11-25/schema.json

5. For implementation of an MCP server, follow the MCP documentation on modelcontextprotocol.io and use the contents of this repository as the authoritative reference for protocol definitions when building your own server in your preferred runtime (Node.js, Python, etc.).

Note: This repository appears to be focused on the MCP specification, protocol schema, and official documentation rather than providing a ready-to-run MCP server instance.

Tips and considerations:

• The primary artifacts are the TypeScript source for the schema (schema/2025-11-25/schema.ts) and the published JSON Schema (schema/2025-11-25/schema.json). Use these to guide implementation and validation of MCP messages.
• Check the Mintlify-built documentation on modelcontextprotocol.io for practical usage examples, integration patterns, and tutorial material.
• If you plan to implement an MCP server, ensure your implementation aligns with the definitions in the schema files, including message shapes, contexts, and any versioned features documented there.
• Since this is a standards/spec repository, expect frequent changes to the schema files as the MCP evolves; lock against a specific schema version when validating against client implementations.
• If you contribute, follow the repository’s CONTRIBUTING.md guidelines linked in README.