使用说明

项目简介

这是一个为 InterviewReady 平台构建的 MCP 服务器,旨在通过标准化的 Model Context Protocol (MCP) 协议,向 LLM 客户端提供 InterviewReady 平台上的博客文章、课程信息和外部资源数据。该服务器允许 LLM 应用便捷地访问和利用 InterviewReady 的知识库内容,从而增强 LLM 在教育和职业发展领域的应用能力。

主要功能点

  • 博客文章检索: 提供多种工具检索 InterviewReady 平台上的博客文章,包括:
    • 获取所有博客文章列表
    • 根据 Slug 获取指定博客文章
    • 根据关键词检索相关博客文章
    • 根据标题检索博客文章
    • 获取博客文章的内容文本
  • 课程信息检索: 提供工具检索 InterviewReady 平台上的课程信息,包括:
    • 获取所有课程列表(仅包含课程 ID、名称、描述和缩略图)
    • 根据课程 ID 获取完整课程信息
  • 外部资源检索: 提供工具检索 InterviewReady 平台推荐的外部学习资源。

安装步骤

  1. 克隆仓库:
    使用 Git 克隆代码仓库到本地:
    git clone https://github.com/InterviewReady/mcp-server.git
  2. 进入仓库目录:
    cd mcp-server
  3. 安装依赖:
    使用 pnpm 包管理器安装项目依赖:
    pnpm install
  4. 构建项目:
    编译 TypeScript 代码生成可执行的 JavaScript 文件:
    pnpm run build

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以下是 Claude Desktop 和 Cursor 客户端的配置示例。你需要将 '{path-to-repo}' 替换为 mcp-server 仓库在您本地文件系统中的实际路径。

Claude Desktop 配置: 编辑 'claude_desktop_config.json' 文件,添加以下 JSON 配置:

{
    "interviewready-mcp-server": {
            "command": "node",
            "args": [
                "{path-to-repo}/mcp-server/build/index.js"
            ]
        }
}

Cursor 配置: 在 Cursor 的设置 (Settings) 中,找到 'MCP' 选项卡,添加以下 JSON 配置:

{
    "interviewready-mcp-server": {
            "command": "node",
            "args": [
                "{path-to-repo}/mcp-server/build/index.js"
            ]
        }
}

基本使用方法

  1. 确保 MCP 服务器已成功构建并配置到 MCP 客户端中。
  2. 在 MCP 客户端(如 Cursor 或 Claude Desktop)的 Agent 模式下,你可以通过自然语言指令调用服务器提供的工具。
  3. 例如,在提示词中提及要获取博客文章或课程信息,客户端将自动调用相应的 MCP 工具并返回结果。

示例指令:

  • "帮我查找关于 React 的博客文章" (客户端可能会调用 'get-blog-post-by-keywords' 工具)
  • "我想了解 InterviewReady 有哪些前端课程" (客户端可能会调用 'get-courses' 工具)

请注意,具体的工具调用和参数传递取决于 MCP 客户端的实现和自然语言理解能力。

信息

分类

数据库与文件