Skip to main content
Glama

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

Related MCP server: Learn MCP Server

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

Available Tools

3 tools
explain_conceptB

Get a beginner-friendly explanation of an MCP concept

Inputs: concept (required).

list_serversC

List available MCP servers by category

Inputs: category (required).

show_exampleB

Show a practical example of an MCP feature

Inputs: feature (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: explain_concept provides explanations, list_servers enumerates available servers, and show_example demonstrates practical usage. An agent can easily distinguish between these three functions.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (explain_concept, list_servers, show_example) with clear, descriptive names. There are no deviations in naming style or conventions.

    Tool Count3/5

    With only 3 tools, the server feels somewhat thin for a 'guide' purpose, which might suggest broader coverage. However, the tools are well-defined and cover core functions, making this borderline but not severely lacking.

    Completeness4/5

    The tools cover key aspects of an MCP guide: explanation, listing, and examples. Minor gaps might include advanced tutorials or troubleshooting, but the surface supports basic learning workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      A basic Model Context Protocol (MCP) server implementation that provides a foundation for MCP server development. The README doesn't specify particular functionality, suggesting it may be a template or starting point for building custom MCP servers.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server designed for learning and experimentation. It provides a foundational setup for developers to build, run, and debug MCP server implementations using Node.js.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An interactive tutorial MCP server that teaches Model Context Protocol through extensively commented code, interactive testing, and hands-on exercises, enabling developers to learn MCP by building and modifying real-world examples.
      MIT