@taotao7/bypass-mcp

bypass-saas 课程平台的 MCP Server，提供课程、文章、学员、订单等管理能力，供 Claude Desktop / Claude Code 等 MCP 客户端调用。

快速开始

1. 获取 API Token

在你部署的 bypass-saas Admin 后台中生成 Token：

1. 登录 Admin 后台
2. 进入 设置 → API Token 管理
3. 点击"生成 Token"，复制生成的 bp_xxx 格式 token

2. 配置 MCP 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "bypass": {
      "command": "npx",
      "args": ["-y", "@taotao7/bypass-mcp"],
      "env": {
        "BYPASS_API_URL": "https://admin.airbypass.com/api",
        "BYPASS_API_TOKEN": "bp_your-token-here"
      }
    }
  }
}

Claude Code

编辑 .claude/settings.json 或全局配置：

{
  "mcpServers": {
    "bypass": {
      "command": "npx",
      "args": ["-y", "@taotao7/bypass-mcp"],
      "env": {
        "BYPASS_API_URL": "https://admin.airbypass.com/api",
        "BYPASS_API_TOKEN": "bp_your-token-here"
      }
    }
  }
}

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | BYPASS_API_URL | 是 | Admin 后台 API 地址（如 https://admin.airbypass.com/api） | | BYPASS_API_TOKEN | 是 | 在 Admin 后台 设置 → API Token 管理 中生成的 Token（bp_xxx 格式） |

可用工具

课程管理

| 工具 | 说明 | |------|------| | bypass_list_courses | 列出课程，支持 status/category_id/search 筛选 + 分页 | | bypass_get_course | 按 ID 获取单个课程详情（含购买项列表） | | bypass_create_course | 创建课程（价格通过购买项管理，非课程级别） | | bypass_update_course | 更新课程，仅更新传入的字段 | | bypass_delete_course | 删除课程 |

课程购买项管理

| 工具 | 说明 | |------|------| | bypass_list_course_items | 列出课程下所有购买项 | | bypass_create_course_item | 创建购买项（价格单位：澳分，content_url 为交付链接，用户购买后通过 iframe 查看） | | bypass_update_course_item | 更新购买项，仅更新传入的字段 | | bypass_delete_course_item | 删除购买项 |

文章管理

| 工具 | 说明 | |------|------| | bypass_list_articles | 列出文章，支持 status/category/search 筛选 + 分页 | | bypass_get_article | 按 ID 获取单篇文章 | | bypass_create_article | 创建文章 | | bypass_update_article | 更新文章，仅更新传入的字段 | | bypass_delete_article | 删除文章 |

用户与学员

| 工具 | 说明 | |------|------| | bypass_list_users | 列出注册用户，支持 search 筛选 + 分页 | | bypass_list_students | 列出学员课程记录（含用户和课程详情），支持搜索 |

订单

| 工具 | 说明 | |------|------| | bypass_list_orders | 列出订单（含用户和课程详情），支持 status 筛选 |

统计与学院

| 工具 | 说明 | |------|------| | bypass_get_stats | 获取平台聚合统计（用户数、课程数、收入、文章数、学员数等） | | bypass_list_categories | 列出所有课程学院 |

技术细节

• 传输方式：stdio
• 数据访问：通过 Admin REST API (/api/v1/*)，使用 API Token 认证
• 所有列表接口支持 limit + offset 分页，返回 total / has_more 元数据

License

MIT