使用说明

项目简介

MCP Guide Server (v0.1.5) 是一个为初学者设计的 Model Context Protocol (MCP) 服务器,旨在帮助用户理解 MCP 协议的核心概念。它通过提供互动示例、MCP 服务器目录和教程 Prompts,引导用户快速上手 MCP 服务器的开发和使用。

主要功能点

  • MCP 概念解释: 通过 'explain_concept' 工具,用户可以获取关于 MCP 工具、资源、Prompt 模板等核心概念的清晰解释,帮助初学者快速理解 MCP 的基本原理。
  • MCP 服务器目录: 'list_servers' 工具提供了一个全面的 MCP 服务器列表,按类别组织,方便用户浏览和发现各种可用的 MCP 服务器。
  • 交互式示例: 'show_example' 工具展示了 MCP 功能的实际应用示例,例如工具调用、资源读取和 Prompt 模板的使用,帮助用户直观地理解 MCP 的工作方式。
  • 教程 Prompts: 提供 'create_tool' 和 'create_resource' 教程 Prompt,指导用户创建自己的 MCP 工具和资源,鼓励用户实践和探索。

安装步骤

你可以通过 npm 或 yarn 全局安装 MCP Guide Server:

# 使用 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": "mcp-guide",  // 启动服务器的命令,前提是 mcp-guide 已添加到系统 PATH 环境变量
      "args": []                 // 启动命令参数,本服务器无需额外参数
    }
  }
}

注意: 如果 'mcp-guide' 命令未添加到 PATH 环境变量,或者你希望从项目本地启动,请将 'command' 设置为 'node','args' 设置为服务器入口文件 'dist/index.js' 的绝对路径。例如:

{
  "mcpServers": {
    "mcp-guide": {
      "command": "node",
      "args": ["/path/to/qpd-v_mcp-guide/dist/index.js"] // 请替换为实际的项目路径
    }
  }
}

基本使用方法

  1. 确保 MCP Guide Server 已成功安装并配置到你的 MCP 客户端。
  2. 在客户端中,你可以通过调用以下工具与服务器交互:
    • explain_concept: 例如,使用 'explain_concept' 工具并传入参数 '{"concept": "tools"}' 可以获取关于 MCP 工具的解释。
    • show_example: 例如,使用 'show_example' 工具并传入参数 '{"feature": "tool_call"}' 可以查看工具调用的示例。
    • list_servers: 例如,使用 'list_servers' 工具并传入参数 '{"category": "browser"}' 可以列出浏览器类别的 MCP 服务器,或使用 '{"category": "all"}' 列出所有类别的服务器。
  3. 你还可以尝试使用 'create_tool' 和 'create_resource' 这两个 Prompt,按照服务器的引导创建你自己的 MCP 工具和资源。

信息

分类

开发者工具