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 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

mcp-guide FAQ

How do I install the MCP Guide Server?

You can install it globally using npm with 'npm install -g mcp-guide' or yarn with 'yarn global add mcp-guide'.

How do I integrate the MCP Guide Server with Claude Desktop?

Add the server configuration to your 'claude_desktop_config.json' under the 'mcpServers' section as specified in the usage instructions.

What kind of MCP concepts does the MCP Guide Server explain?

It covers core MCP concepts such as tools, resources, prompts, and best practices for building MCP integrations.

Can I see practical examples of MCP features using this server?

Yes, the server provides interactive examples that demonstrate MCP capabilities in action.

Does the MCP Guide Server list other MCP servers?

Yes, it includes a comprehensive directory of available MCP servers organized by category.

Is the MCP Guide Server suitable for experienced MCP developers?

While it is beginner-friendly, experienced developers can also use it as a reference and to explore new MCP servers and examples.

What platforms support the MCP Guide Server?

It can be used with MCP hosts like Claude Desktop and is installable via npm or yarn, making it compatible with most Node.js environments.

Are there tutorials included to help build MCP tools?

Yes, the server offers step-by-step tutorial prompts to guide you through creating your first MCP tools and resources.