About Guide
Guide is an MCP server published by qpd-v in the Developer Tools category: 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.
The repository has 67 stars and 14 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/qpd-v/mcp-guideThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Guide
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
Installation
# Using npm
npm install -g mcp-guide
# Using yarn
yarn global add mcp-guide
Usage
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-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
README fetched from the repository 5 days ago. The original is authoritative.