MCP Guide Server 使用说明

项目简介

MCP Guide Server (MCP指南服务器) 是一个为了帮助开发者理解 Model Context Protocol (MCP) 而设计的服务器。它通过提供清晰的概念解释、互动示例和MCP服务器目录，旨在成为开发者学习和使用MCP协议的得力助手。

主要功能点

MCP概念解释: 提供对 MCP 核心概念（如工具、资源、Prompt模板等）的初学者友好的解释。
MCP服务器目录: 收录并分类整理了大量可用的 MCP 服务器，方便用户浏览和发现。
互动示例: 展示 MCP 功能的实际应用示例，帮助用户直观理解。
教程Prompt: 提供创建第一个 MCP 工具和资源的步骤指南。

安装步骤

可以通过 npm 或 yarn 全局安装 'mcp-guide'：

# 使用 npm
npm install -g mcp-guide

# 使用 yarn
yarn global add mcp-guide

服务器配置

要将 MCP Guide Server 与 MCP 客户端（如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器信息。以 Claude Desktop 为例，在 'claude_desktop_config.json' 文件中，添加如下配置：

{
  "mcpServers": {
    "mcp-guide": {
      "command": "node",
      "args": ["/path/to/global/node_modules/mcp-guide/dist/index.js"]
      // 注意: 请将 "/path/to/global/node_modules/mcp-guide/dist/index.js" 
      // 替换为您的系统中 'mcp-guide' 全局安装的实际路径。
      // 您可以使用 'npm list -g mcp-guide' 或 'yarn global list mcp-guide' 命令查找全局安装路径。
    }
  }
}

请务必将 'args' 中的路径替换为您环境中 'mcp-guide' 的实际安装路径。 您可以通过在终端中运行 'which mcp-guide' (macOS/Linux) 或 'where mcp-guide' (Windows) 查找 'mcp-guide' 命令的路径，然后根据该路径推断出 'index.js' 文件的完整路径。

基本使用方法

启动服务器: 安装完成后，您可以在终端中直接运行 'mcp-guide' 命令来启动服务器。如果全局安装的路径没有添加到环境变量，可能需要使用 'npx mcp-guide' 或指定 'node /path/to/mcp-guide/dist/index.js' 来运行。
在 MCP 客户端中使用: 配置完成后，重启您的 MCP 客户端（如 Claude Desktop）。您应该能在客户端中看到 'mcp-guide' 服务器。
使用工具: MCP Guide Server 提供了以下工具，您可以在客户端中调用这些工具来学习 MCP 概念和浏览服务器列表：
- 'explain_concept': 获取 MCP 概念的解释。例如，您可以让 Claude 调用此工具并输入 'concept: "tools"' 来了解 "工具" 的概念。
- 'show_example': 查看 MCP 功能的示例。例如，使用 'feature: "tool_call"' 查看工具调用的示例。
- 'list_servers': 列出可用的 MCP 服务器。可以使用 'category' 参数指定服务器类别，例如 'category: "database"'，或者使用 'category: "all"' 列出所有类别。

通过这些工具和资源，您可以更轻松地理解和上手 MCP 协议及其应用。

关键词