MCP Guide

🚀 MCP Guide Server (v0.1.5)

A beginner-friendly Model Context Protocol (MCP) server designed to help users understand MCP concepts, provide interactive examples, and list available MCP servers. This server is tailored for developers working with MCP, serving as a practical assistant.

Author: qpd-v

✨ Features

• 📚 Concept Explanation: Get clear, beginner-oriented explanations of MCP concepts, such as tools, resources, and prompts.
• 🔍 Server Directory: Browse a comprehensive list of available MCP servers organized by category.
• 💡 Interactive Examples: View real-world examples of MCP functionality.
• 🛠️ Tutorial Tips: Follow step-by-step guides to create your first MCP tools and resources.

📦 Installation

# Using npm
npm install -g mcp-guide

# Using yarn
yarn global add mcp-guide

💻 Usage Examples

Usage in Claude Desktop

1. Add the server to your Claude Desktop configuration file (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 an explanation of an MCP concept.
   • show_example: View a real-world example of MCP functionality.
   • list_servers: Browse available MCP servers by category.

Standalone Execution

# Start the server
mcp-guide

# Or if installed locally
npx mcp-guide

Available Tools

explain_concept

Get a clear explanation of an MCP concept.

Example concepts:

• tools
• resources
• prompts
• server
• client
• server_types
• frameworks
• clients

show_example

Show a real-world example of an MCP functionality.

Example functionalities:

• 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

🔧 Technical Details

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

🤝 Contribution

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

• [ ] Implement interactive installation from the server list.
• [ ] Add more interactive examples and tutorials.
• [ ] Improve server categorization and search functionality.