MCP-Guide

JavaScript
Apache-2.0
193
8
A
security – no known vulnerabilities (report Issue)
A
license - permissive license (Apache-2.0)
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. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription
create_toolGuide for creating your first MCP tool
create_resourceGuide for creating your first MCP resource

Resources

Contextual data attached and managed by the client

NameDescription
MCP OverviewHigh-level introduction to MCP concepts
Understanding ToolsDeep dive into MCP tools
Understanding ResourcesDeep dive into MCP resources
Understanding PromptsDeep dive into MCP prompts

Tools

Functions exposed to the LLM to take actions

NameDescription
explain_conceptGet a beginner-friendly explanation of an MCP concept
show_exampleShow a practical example of an MCP feature
list_serversList available MCP servers by category

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

README.md

MCP Guide Server (v0.1.4)

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

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • -
    security
    -
    license
    -
    quality
    Tools for executing JQL queries. Tools for creating, editing, and deleting Jira tickets. Tools for listing Jira projects and statuses
    • Apple
  • -
    security
    A
    license
    -
    quality
    MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
    MIT
  • -
    security
    A
    license
    -
    quality
    A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.
    MIT
  • A
    security
    A
    license
    A
    quality
    MCP Server for the GitLab API, enabling project management, file operations, and more.
    MIT