WDP MCP Tools

Weimob Development Platform Tools packaged as an MCP (Model Context Protocol) provider.

Installation

You can install this package globally to use with npx:

npm install -g wdp-mcp-tools

Or run directly with npx without installing:

npx wdp-mcp-tools

Usage

This package provides MCP tools for interacting with the Weimob Development Platform.

To use with an MCP-compatible client, configure the client to use this tool as an MCP provider.

Development

To develop and test locally:

1. Clone the repository
2. Install dependencies: npm install
3. Run the tool: node bin/wdp-mcp.js

Publishing

To publish a new version:

1. Update the version in package.json
2. Login to npm: npm login
3. Publish: npm publish

WDP DevOps 工具集

微盟开发平台(WDP) DevOps 工具集，提供项目管理、API调用、服务部署等功能。

功能特性

• API调用: 直接调用微盟开发平台的各种API
• 项目信息查询: 获取项目详细信息
• 服务部署: 部署服务到指定环境
• CAS登录: 通过CAS系统登录获取认证ticket和EGG_SESS_CEP cookie

技术栈

• Node.js
• Express.js
• dotenv
• morgan
• helmet
• cors

安装

npm install -g wdp-devops

使用方式

作为MCP工具使用

npx wdp-mcp

作为普通CLI工具使用

wdp --help

支持的工具

1. wdp-login (新增)

用于通过CAS系统登录获取认证信息，包括关键的 EGG_SESS_CEP cookie。

使用示例:

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"wdp-login","arguments":{}},"id":1}' | npx wdp-mcp

返回结果:

{
  "success": true,
  "message": "Login successful, authentication data (including EGG_SESS_CEP) saved"
}

用户需要在浏览器中打开返回的URL完成登录流程，登录成功后系统会自动生成并保存认证信息，包括 EGG_SESS_CEP cookie。

2. wdp-api-call

调用微盟开发平台API。

参数:

• endpoint (必需): API端点路径
• method (可选): HTTP方法 (GET, POST, PUT, DELETE)，默认为GET
• data (可选): 请求数据

使用示例:

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"wdp-api-call","arguments":{"endpoint":"/api/v1/projects","method":"GET"}},"id":1}' | npx wdp-mcp

3. wdp-project-info

获取项目信息。

参数:

• projectId (必需): 项目ID

使用示例:

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"wdp-project-info","arguments":{"projectId":"12345"}},"id":1}' | npx wdp-mcp

4. wdp-deploy-service

部署服务。

参数:

• serviceId (必需): 服务ID
• environment (必需): 部署环境 (dev, test, prod)
• version (可选): 部署版本

使用示例:

echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"wdp-deploy-service","arguments":{"serviceId":"service-123","environment":"dev","version":"v1.0.0"}},"id":1}' | npx wdp-mcp

认证机制说明

本工具集通过CAS单点登录系统进行认证。认证流程如下：

1. 用户调用 wdp-login 工具
2. 系统自动打开浏览器并跳转到CAS登录页面
3. 用户在CAS页面完成身份验证
4. CAS系统将用户重定向回本地回调地址，并附带一次性ticket
5. 本地服务验证ticket并向服务器请求用户信息
6. 服务器验证通过后，设置关键认证cookie EGG_SESS_CEP
7. 本地服务捕获所有认证信息并保存到配置文件
8. 后续API调用会自动使用保存的认证信息

EGG_SESS_CEP 是一个 HttpOnly 类型的 cookie，无法通过 JavaScript 直接访问，但会在 HTTP 请求中自动发送。

MCP协议支持

本服务完全支持MCP协议，提供以下端点：

• /mcp - MCP协议端点（JSON-RPC）
• /api/mcp/tools - 获取可用工具列表（REST API）
• /api/mcp/tools/:toolName - 执行指定工具（REST API）

MCP方法

1. ping - 心跳检测
2. tools/list - 获取工具列表
3. tools/call - 调用工具

快速开始

安装依赖

npm install

启动服务

# 生产环境
npm start

# 开发环境（带热重载）
npm run dev

文档

• 项目概述
• API文档

API端点

• GET / - 服务信息
• GET /health - 健康检查
• GET /api/mcp/tools - 获取可用工具列表
• POST /api/mcp/tools/:toolName - 执行指定工具
• POST /mcp - MCP协议端点

许可证

ISC

wdp-devops

微盟开发平台(MCP)工具集

工具列表

登录相关工具

1. wdp-puppeteer-login: 使用Puppeteer登录到微盟开发平台

   • 用法: wdp-puppeteer-login [forceUpdate]
   • 参数:
     • forceUpdate (boolean, 可选): 是否强制重新登录

2. wdp-get-egg-sess-cep: 获取关于EGG_SESS_CEP Cookie的信息

   • 用法: wdp-get-egg-sess-cep

API调用工具

3. wdp-api-call: 调用微盟开发平台API
   • 用法: wdp-api-call <endpoint> [method] [data]
   • 参数:
     • endpoint (string, 必需): API端点路径，例如: /api/app/list
     • method (string, 可选): HTTP方法 (GET, POST, PUT, DELETE)，默认为GET
     • data (object, 可选): 请求数据

应用管理工具

4. wdp-get-app-list: 获取应用列表

   • 用法: wdp-get-app-list [pageSize] [pageNum]
   • 参数:
     • pageSize (number, 可选): 每页条数，默认为10
     • pageNum (number, 可选): 页码，默认为1

5. wdp-get-app-detail: 获取应用详情

   • 用法: wdp-get-app-detail <appId>
   • 参数:
     • appId (string, 必需): 应用ID

6. wdp-get-project-list: 获取项目列表

   • 用法: wdp-get-project-list [pageSize] [pageNum]
   • 参数:
     • pageSize (number, 可选): 每页条数，默认为10
     • pageNum (number, 可选): 页码，默认为1

7. wdp-get-menu-info: 获取菜单信息

   • 用法: wdp-get-menu-info [subSystemName]
   • 参数:
     • subSystemName (string, 可选): 子系统名称，默认为'dev-console'

8. wdp-get-component-center-info: 获取组件中心信息

   • 用法: wdp-get-component-center-info

9. wdp-get-ability-center-info: 获取能力中心信息

   • 用法: wdp-get-ability-center-info

使用说明

1. 首先使用 wdp-puppeteer-login 登录到微盟开发平台
2. 然后可以使用其他工具进行API调用

示例

# 登录
wdp-puppeteer-login

# 获取应用列表
wdp-get-app-list 20 1

# 获取特定应用详情
wdp-get-app-detail blaze-dropshipping-product

# 获取项目列表
wdp-get-project-list 10 1

# 获取菜单信息
wdp-get-menu-info dev-console

# 直接调用API接口
wdp-api-call /api/app/list GET