Descope MCP Server

🚀 Descope MCP 服务器描述

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

🚀 快速开始

简介

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

可用工具

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

✨ 主要特性

Descope MCP 服务器具备多种实用工具，可便捷地对 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 服务器。