📌Overview

Purpose: To provide a beginner-friendly Model Context Protocol (MCP) server that aids in understanding MCP concepts through interactive examples and resources for developers.

Overview: The MCP Guide Server serves as a supportive tool for developers interested in MCP, offering clear explanations, a directory of available servers, and interactive examples that illustrate key features of the protocol. This server is designed to be an accessible resource for those new to the MCP framework.

Key Features:

• Concept Explanations: Offers beginner-friendly descriptions of crucial MCP concepts, helping users grasp the fundamentals of tools, resources, prompts, and more.

• Server Directory: Allows users to explore a well-organized list of MCP servers categorized for easy navigation, enabling quick access to relevant resources.

• Interactive Examples: Provides real-world examples showcasing MCP features, allowing users to see practical applications and better understand functionality.

• Tutorial Prompts: Supplies step-by-step guides for creating initial MCP tools and resources, facilitating hands-on learning and practical engagement with MCP concepts.

---

MCP Guide Server (v0.1.5)

A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts and provides interactive examples. This server is designed to be a helpful companion for developers working with MCP.

Author: qpd-v

Features

• Concept Explanations: Clear explanations of MCP concepts like tools, resources, prompts, and more.
• Server Directory: A comprehensive list of available MCP servers organized by category.
• Interactive Examples: Practical examples of MCP features in action.
• Tutorial Prompts: Step-by-step guides for creating your first MCP tools and resources.

Installation

# Using npm
npm install -g mcp-guide

# Using yarn
yarn global add mcp-guide

Usage

With Claude Desktop

1. Add the server to your Claude Desktop configuration (claude_desktop_config.json):

   {
     "mcpServers": {
       "mcp-guide": {
         "command": "node",
         "args": ["path/to/mcp-guide/dist/index.js"]
       }
     }
   }
   

2. Restart Claude Desktop.

3. Use the available tools:

   • explain_concept: Get explanations of MCP concepts.
   • show_example: See practical examples of MCP features.
   • list_servers: Browse available MCP servers by category.

Standalone

# Start the server
mcp-guide

Available Tools

• explain_concept: Get beginner-friendly explanations of MCP concepts.
• show_example: Show practical examples of MCP features.
• list_servers: List available MCP servers by category.

Development

# Clone the repository
git clone https://github.com/qpd-v/mcp-guide.git
cd mcp-guide

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Roadmap

• Interactive server installation from the server list.
• More interactive examples and tutorials.
• Enhanced server categorization and search.