返回 MCP 目录
public公开dns本地运行

descope-mcp-server

Descope MCP服务器是一个与Descope管理API交互的接口,用于搜索和检索项目相关信息,包括用户管理和审计日志查询等功能。

article

README

🚀 Descope MCP 服务器描述

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

smithery badge

🚀 快速开始

简介

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
  1. 安装必要的依赖项:
npm install
  1. 构建项目:
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 服务器。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端