mcp-guide

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"]
    }
  }
}

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

# 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