MCP-Guide
This server is a beginner-friendly guide to the Model Context Protocol (MCP), offering three main capabilities:
📚 Learn MCP Concepts: Get explanations of concepts like tools, resources, prompts, and framework components using the
explain_concepttool.💡 Explore MCP Features: See practical examples of features such as tool_call, resource_read, and prompt_template with the
show_exampletool.🔍 Browse MCP Servers: List and explore available MCP servers organized by categories like browser, cloud, database, security, and more using the
list_serverstool.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Guide explain what MCP tools are"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-guideUsage
With Claude Desktop
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"]
}
}
}Restart Claude Desktop
Use the available tools:
explain_concept: Get explanations of MCP conceptsshow_example: See practical examples of MCP featureslist_servers: Browse available MCP servers by category
Standalone
# Start the server
mcp-guide
# Or if installed locally
npx mcp-guideAvailable 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 startContributing
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 toolsexplain_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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for AI dialogue using various LLM models via AceDataCloud
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Related MCP Servers
- FlicenseBqualityDmaintenanceA 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-
- FlicenseNot gradedqualityDmaintenanceA 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.-
- FlicenseNot gradedqualityDmaintenanceAn educational MCP server that teaches implementing the Model Context Protocol from scratch, enabling AI models to discover and invoke tools via JSON-RPC over stdio.-
- AlicenseNot gradedqualityDmaintenanceAn 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