MCP-Guide

by qpd-v

MCP Guide Server (v0.1.5)

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

Author: qpd-v

Features

  • 📚 Concept Explanations: Get clear, beginner-friendly explanations of MCP concepts like tools, resources, prompts, and more
  • 🔍 Server Directory: Browse a comprehensive list of available MCP servers organized by category
  • 💡 Interactive Examples: See 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"] } } }
  1. Restart Claude Desktop
  2. 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 # Or if installed locally npx mcp-guide

Available Tools

explain_concept

Get a beginner-friendly explanation of an MCP concept.

Example concepts:

  • tools
  • resources
  • prompts
  • server
  • client
  • server_types
  • frameworks
  • clients

show_example

Show a practical example of an MCP feature.

Example features:

  • tool_call
  • resource_read
  • prompt_template

list_servers

List available MCP servers by category.

Categories:

  • browser
  • cloud
  • command_line
  • communication
  • customer_data
  • database
  • developer
  • data_science
  • filesystem
  • finance
  • knowledge
  • location
  • monitoring
  • search
  • travel
  • version_control
  • other

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.

  1. Features
    1. Installation
      1. Usage
        1. With Claude Desktop
        2. Standalone
      2. Available Tools
        1. explain_concept
        2. show_example
        3. list_servers
      3. Development
        1. Contributing
          1. License
            1. Roadmap

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
                Last updated -
                4
                3
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                A dynamic service that creates and manages Model Context Protocol (MCP) servers, allowing users to spawn, customize, and control multiple MCP servers as child processes.
                Last updated -
                5
                21
                TypeScript
                MIT License
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.
                Last updated -
                1
                88
                Python
                MIT License
                • Apple
                • Linux
              • -
                security
                -
                license
                -
                quality
                A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
                Last updated -
                1
                TypeScript

              View all related MCP servers

              ID: 3jsu6wpgzt