MCP Spec

🚀 MCP Specification Server

This project transforms the Model Context Protocol documentation into an MCP server, enabling your LLM to access the full MCP specifications. You can query specific sections such as "Tools", "Resources", "Authorization", and over 20 others to obtain comprehensive documentation for each section.

🚀 Quick Start

Add this server to any MCP-compatible client (Claude Desktop, Cursor, VSCode, Windsurf, etc.):

Claude Desktop Config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor config: Chat Settings, Tools / Integrations. Edit mcp.json

{
  "mcpServers": {
    "mcp-spec": {
      "command": "npx",
      "args": ["-y", "@mcpjam/mcp-spec@latest"]
    }
  }
}

✨ Features

📚 Complete MCP Specification Access

• 364KB of comprehensive MCP documentation indexed and searchable.
• 25+ distinct sections covering every aspect of the protocol.
• Complete section content returned, not just snippets.

⚡ Smart Document Processing

• Intelligent chunking by major headings (# tags).
• 500 - line chunk limits for optimal performance.
• Fast startup indexing (<1 second).

🔧 Developer - Focused Sections

• Tools - Function calling and tool execution patterns.
• Resources - Data access and resource management.
• Authorization - Security, authentication, and authorization.
• Transports - Communication layers (stdio, HTTP, SSE).
• Debugging - Troubleshooting and development tools.
• Core components - Protocol architecture fundamentals.
• Connection lifecycle - Initialization and termination.
• And 18+ more specialized sections.

🛠️ Built for MCP Development

• Ideal for developers building MCP servers or clients.
• Reference implementation patterns and best practices.
• Complete protocol specifications at your fingertips.

💻 Usage Examples

Basic Usage

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│  MCP Spec Server │◄──►│ Specification   │
│   (Claude,      │    │                  │    │ Document        │
│    Your App)    │    │  - Section Index │    │ (llms-full.md)  │
└─────────────────┘    │  - Content Cache │    └─────────────────┘
                       │  - Search Logic  │
                       └──────────────────┘

The process works as follows:

1. Server indexes the complete MCP specification on startup.
2. Document is split into sections by major headings.
3. Query by section name to get the full content for that section.
4. Returns complete documentation for topics like Tools, Resources, Authorization, etc.

📦 Installation

You can install the server using an IDE. Follow the steps described in the "Install with an IDE" section above.

🤝 Contributing

If you want to improve this server, here's how:

# 1. Clone the repository
git clone https://github.com/your-org/mcp-spec.git
cd mcp-spec

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Start development server
npm run dev

Development workflow:

1. Fork this repository.
2. Create a feature branch: git checkout -b my-feature.
3. Make your changes.
4. Test locally: npm run build && npm run dev.
5. Submit a pull request.

• Community: Join the MCP community discussions.

📄 License

This project is licensed under the MIT License.

⚠️ Important Note

This is an unofficial server created to make the MCP specification more accessible. For official MCP resources and documentation, visit modelcontextprotocol.io.