Descope MCP 服务器描述

简介

Descope 模型上下文协议 (MCP) 服务器提供了一个接口，用于与 Descope 的管理 API 进行交互，从而实现对项目相关信息的搜索和检索。

可用工具

• search-audits: 从你的 Descope 项目中检索最多 10 条审核日志记录。
• search-users: 从你的 Descope 项目中检索最多 10 条用户记录。
• create-user: 在你的 Descope 项目中创建新用户。
• invite-user: 邀请新的用户加入你的 Descope 项目。

先决条件

在继续之前，请确保你具备以下条件：

• Node.js (版本 18 或更高) 已安装
• Claude Desktop 已安装在你的系统上
• 有效的 Descope 项目 ID 和 管理密钥
• Git 已安装

要确认 Node.js 的安装情况，请运行以下命令：

node --version  # 预期输出: v18.0.0 或更高版本

安装说明

通过 Smithery 自动安装

使用 Smithery 自动安装 Descope MCP 服务器以适用于 Claude Desktop：

npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude

手动安装

1. 克隆仓库：

   git clone https://github.com/descope-sample-apps/descope-mcp-server.git
   cd descope-mcp-server
   

2. 安装必要的依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

配置

1. 配置 Claude Desktop 以识别 Descope MCP 服务器

要定位 claude_desktop_config.json 文件，请打开 Claude Desktop 应用，然后从菜单栏的左上角启用开发者模式。

启用后，转到设置（同样在菜单栏的左上角），导航到“开发者”部分，并点击“编辑配置”按钮以访问和编辑 claude_desktop_config.json。

或者，直接通过终端打开配置文件：

在 macOS 上：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上：

code %APPDATA%\Claude\claude_desktop_config.json

2. 添加 Descope 服务器的配置：

{
  "mcpServers": {
    "descope": {
      "command": "node",
      "args": ["--loader", "ts-node/esm"],
      "options": ["--loader", "ts-node/esm"],
      "cwd": "${file.path}",
      "config": {
        "type": "stdio",
        "encoding": "utf8",
        "interactive": false,
        "tty": false
      },
      "stdio": "inherit"
    }
  }
}

将上述内容添加到 claude_desktop_config.json 文件中，并将占位符替换为你的实际项目 ID 和管理密钥。

3. 运行服务器

配置完成后，你可以通过以下命令运行服务器：

npm run start

注意事项

• 确保 Node.js 版本符合要求。
• 在编辑配置文件时，小心处理路径和占位符。
• 如果在安装或配置过程中遇到问题，请检查终端输出的错误信息，并确保所有依赖项已正确安装。

通过以上步骤，你应该能够成功设置并运行 Descope MCP 服务器。