home / mcp / mcp guide server

MCP Guide Server

A beginner-friendly guide server that helps users understand MCP concepts, provides interactive examples, and demonstrates best practices for building MCP integrations. Features tools for exploring MCP capabilities, resources for learning core concepts, and prompts for guided tutorials.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can use this MCP server as a hands-on guide to learn Model Context Protocol concepts, see interactive examples, and browse available MCP servers. It explains tools, resources, prompts, and more in clear, beginner-friendly terms while letting you try practical patterns directly.

How to use

You connect to the MCP Guide Server from your MCP client to access explanations, live examples, and a directory of MCP servers. Use it to learn concepts, run example scenarios, and explore servers by category. You can start with the built-in explanations for concepts like tools, resources, prompts, and server types, then try concrete demonstrations of tool calls, resource reads, and prompt templates.

To begin, set up your MCP client to reach the server through either a local stdio integration or a remote HTTP endpoint if provided by your setup. When you initiate a session, you can request explanations of concepts, view practical examples, and list available servers by category to guide your next steps.

If your client supports adding MCP servers via a configuration file, you can include the following example configurations to connect to the MCP Guide Server. The first configuration uses a node process that runs the MCP Guide Server from a built distribution, and the second shows starting the server directly via a CLI entry point.

How to install

Prerequisites: you need Node.js and a package manager to install and run MCP-related tools.

Install the MCP Guide Server globally using npm or yarn so you can run it from anywhere.

# Using npm
npm install -g mcp-guide

# Using yarn
yarn global add mcp-guide

Additional setup and usage notes

If you plan to connect via a desk-based MCP client like Claude Desktop, you can configure the client to load MCP Guide as a local server. You’ll point the client to the appropriate command path or executable that runs the MCP Guide Server.

Standalone usage also works directly from the command line once the package is installed. You can start the server with the CLI entry point.

# Start the server using the CLI entry point
mcp-guide

# Or, if you installed it locally, run via npx
npx mcp-guide

Available tools

explain_concept

Provide beginner-friendly explanations of MCP concepts such as tools, resources, prompts, and server/client roles.

show_example

Display practical MCP feature examples, including tool_call, resource_read, and prompt_template demonstrations.

list_servers

List available MCP servers organized by category to help you discover new capabilities.