descope-sample-apps_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 项目。

📦 安装指南

先决条件

开始之前，请确保以下几点：

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

确认 Node.js 安装：

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

使用 Smithery 自动安装

通过 Smithery 自动为 Claude Desktop 安装 Descope MCP 服务器：

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 服务器

要定位 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": ["/path/to/descope-mcp-server/build/index.js"],
      "env": {
        "DESCOPE_PROJECT_ID": "your-descope-project-id-here",
        "DESCOPE_MANAGEMENT_KEY": "your-descope-management-key-here"
      }
    }
  }
}

替换 your-descope-project-id-here 和 your-descope-management-key-here 为你的实际 Descope 项目 ID 和管理密钥。

3. 重启 Claude Desktop

应用更改：

1. 完全退出 Claude Desktop（确保它不是最小化而是完全关闭）。
2. 重新启动 Claude Desktop。
3. 检查 🔌 图标以确认 Descope 服务器已连接。

运行

完成配置后，可以运行以下命令启动服务器：

node index.js

这将启动 Descope MCP 服务器，允许与 Claude Desktop 进行交互。