mcp-server-esa 1.0.0

package/src/tools/record.ts

@@ -0,0 +1,115 @@
+import { CallToolRequest, Tool } from '@modelcontextprotocol/sdk/types.js';
+import api from '../utils/service.js';
+import {
+  CreateRoutineRelatedRecordRequest,
+  DeleteRoutineRelatedRecordRequest,
+} from '@alicloud/esa20240910';
+import { ListRoutineRelatedRecordsRequest } from '../utils/types.js';
+
+export const RECORD_CREATE_TOOL: Tool = {
+  name: 'record_create',
+  description: 'Create a record',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'The name of the routine',
+      },
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      recordName: {
+        type: 'string',
+        description: 'The name of the record',
+      },
+    },
+    required: ['name', 'siteId', 'recordName'],
+  },
+};
+
+export const RECORD_DELETE_TOOL: Tool = {
+  name: 'record_delete',
+  description: 'Delete a record',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'The name of the routine',
+      },
+      recordId: {
+        type: 'number',
+        description: 'The ID of the record',
+      },
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      recordName: {
+        type: 'string',
+        description: 'The name of the record',
+      },
+    },
+    required: ['name', 'siteId', 'recordName'],
+  },
+};
+
+export const RECORD_LIST_TOOL: Tool = {
+  name: 'record_list',
+  description: 'List all records',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      Name: {
+        type: 'string',
+        description: 'The name of the routine',
+      },
+      PageNumber: {
+        type: 'number',
+        description: 'The page number of the records',
+      },
+      PageSize: {
+        type: 'number',
+        description: 'The page size of the records',
+      },
+      SearchKeyWord: {
+        type: 'string',
+        description: 'The search key word of the records',
+      },
+    },
+    required: ['Name'],
+  },
+};
+
+export const record_create = async (request: CallToolRequest) => {
+  const res = await api.createRoutineRelatedRecord(
+    request.params.arguments as CreateRoutineRelatedRecordRequest,
+  );
+
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};
+
+export const record_delete = async (request: CallToolRequest) => {
+  const res = await api.deleteRoutineRelatedRecord(
+    request.params.arguments as DeleteRoutineRelatedRecordRequest,
+  );
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};
+
+export const record_list = async (request: CallToolRequest) => {
+  const res = await api.listRoutineRelatedRecords(
+    request.params.arguments as unknown as ListRoutineRelatedRecordsRequest,
+  );
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};

package/src/tools/route.ts

@@ -0,0 +1,314 @@
+import { CallToolRequest, Tool } from '@modelcontextprotocol/sdk/types.js';
+import api from '../utils/service.js';
+import {
+  CreateRoutineRouteRequest,
+  DeleteRoutineRouteRequest,
+  GetRoutineRouteRequest,
+  ListRoutineRoutesRequest,
+  ListSiteRoutesRequest,
+  UpdateRoutineRouteRequest,
+} from '@alicloud/esa20240910';
+import { transferRouteToRuleString } from '../utils/helpers.js';
+
+export const ROUTE_CREATE_TOOL: Tool = {
+  name: 'route_create',
+  description: 'Create a edge routine(ER) related route',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      mode: {
+        type: 'enum',
+        enum: ['simple', 'custom'],
+        description: 'The mode of the route, default is simple',
+      },
+      route: {
+        type: 'string',
+        description:
+          'The route of the route, if mode is simple, this field is required',
+      },
+      rule: {
+        type: 'string',
+        description:
+          'The rule of the route, if mode is custom, this field is required',
+      },
+      routineName: {
+        type: 'string',
+        description: 'The name of the routine',
+      },
+      routeName: {
+        type: 'string',
+        description: 'The name of the route, use to identify the route',
+      },
+      bypass: {
+        type: 'enum',
+        enum: ['on', 'off'],
+        description: 'The bypass of the route, default is off',
+      },
+      routeEnable: {
+        type: 'enum',
+        enum: ['on', 'off'],
+        description: 'The enable of the route, default is on',
+      },
+      sequence: {
+        type: 'number',
+        description:
+          'The sequence of the route, if not passed, default is the current number of routes',
+      },
+    },
+    required: [
+      'siteId',
+      'mode',
+      'rule',
+      'routineName',
+      'routeName',
+      'bypass',
+      'routeEnable',
+    ],
+  },
+};
+
+export const ROUTE_UPDATE_TOOL: Tool = {
+  name: 'route_update',
+  description: 'Update a routine related route',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      configId: {
+        type: 'number',
+        description: 'The ID of the config',
+      },
+      routeName: {
+        type: 'string',
+        description: 'The name of the route, use to identify the route',
+      },
+      routeEnable: {
+        type: 'enum',
+        enum: ['on', 'off'],
+        description: 'The enable of the route',
+      },
+      rule: {
+        type: 'string',
+        description: 'The rule of the route',
+      },
+      routineName: {
+        type: 'string',
+        description: 'The name of the routine',
+      },
+      bypass: {
+        type: 'enum',
+        enum: ['on', 'off'],
+        description: 'The bypass of the route ',
+      },
+      sequence: {
+        type: 'number',
+        description:
+          'The sequence of the route, if not passed, default is the current number of routes',
+      },
+    },
+    required: [
+      'siteId',
+      'configId',
+      'routeName',
+      'routeEnable',
+      'rule',
+      'routineName',
+      'bypass',
+    ],
+  },
+};
+
+export const ROUTE_DELETE_TOOL: Tool = {
+  name: 'route_delete',
+  description: 'Delete a routine related route',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      configId: {
+        type: 'number',
+        description: 'The ID of the config',
+      },
+    },
+    required: ['siteId', 'configId'],
+  },
+};
+
+export const ROUTE_GET_TOOL: Tool = {
+  name: 'route_get',
+  description: 'Get a routine related route',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      configId: {
+        type: 'number',
+        description: 'The ID of the config',
+      },
+    },
+    required: ['siteId', 'configId'],
+  },
+};
+
+export const ROUTINE_ROUTE_LIST_TOOL: Tool = {
+  name: 'routine_route_list',
+  description: 'List all routes of a routine',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      routineName: {
+        type: 'string',
+        description: 'The name of the routine',
+      },
+      routeName: {
+        type: 'string',
+        description: 'The name of the route, use to filter list results',
+      },
+
+      pageNumber: {
+        type: 'number',
+        description: 'The page number of the routes',
+      },
+      pageSize: {
+        type: 'number',
+        description: 'The page size of the routes',
+      },
+    },
+    required: ['routineName'],
+  },
+};
+
+// export interface ListSiteRoutesReq {
+//     SiteId: number;
+//     ConfigId?: number;
+//     ConfigType?: string;
+//     RouteName?: string;
+//     PageNumber?: number;
+//     PageSize?: number;
+//     RegionId?: string;
+//   }
+
+export const SITE_ROUTE_LIST_TOOL: Tool = {
+  name: 'site_route_list',
+  description: 'List all routes of a site',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      siteId: {
+        type: 'number',
+        description: 'The ID of the site',
+      },
+      routeName: {
+        type: 'string',
+        description: 'The name of the route, use to filter list results',
+      },
+
+      pageNumber: {
+        type: 'number',
+        description: 'The page number of the routes',
+      },
+      pageSize: {
+        type: 'number',
+        description: 'The page size of the routes',
+      },
+    },
+    required: ['siteId'],
+  },
+};
+export const route_create = async (request: CallToolRequest) => {
+  const { mode, route } = request.params.arguments as CreateRoutineRouteRequest;
+
+  if (mode === 'simple') {
+    const res = await api.createRoutineRoute({
+      ...request.params.arguments,
+      rule: transferRouteToRuleString(route),
+    } as unknown as CreateRoutineRouteRequest);
+    return {
+      content: [{ type: 'text', text: JSON.stringify(res) }],
+      success: true,
+    };
+  } else {
+    const res = await api.createRoutineRoute(
+      request.params.arguments as CreateRoutineRouteRequest,
+    );
+    return {
+      content: [{ type: 'text', text: JSON.stringify(res) }],
+      success: true,
+    };
+  }
+};
+
+export const route_delete = async (request: CallToolRequest) => {
+  const res = await api.deleteRoutineRoute(
+    request.params.arguments as DeleteRoutineRouteRequest,
+  );
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};
+
+export const route_update = async (request: CallToolRequest) => {
+  const { mode, route } = request.params.arguments as CreateRoutineRouteRequest;
+  if (mode === 'simple') {
+    const res = await api.updateRoutineRoute({
+      ...request.params.arguments,
+      rule: transferRouteToRuleString(route),
+    } as unknown as UpdateRoutineRouteRequest);
+    return {
+      content: [{ type: 'text', text: JSON.stringify(res) }],
+      success: true,
+    };
+  } else {
+    const res = await api.updateRoutineRoute(
+      request.params.arguments as UpdateRoutineRouteRequest,
+    );
+    return {
+      content: [{ type: 'text', text: JSON.stringify(res) }],
+      success: true,
+    };
+  }
+};
+
+export const route_get = async (request: CallToolRequest) => {
+  const res = await api.getRoutineRoute(
+    request.params.arguments as GetRoutineRouteRequest,
+  );
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};
+
+export const routine_route_list = async (request: CallToolRequest) => {
+  const res = await api.listRoutineRoutes(
+    request.params.arguments as ListRoutineRoutesRequest,
+  );
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};
+
+export const site_route_list = async (request: CallToolRequest) => {
+  const res = await api.listSiteRoutes(
+    request.params.arguments as ListSiteRoutesRequest,
+  );
+  return {
+    content: [{ type: 'text', text: JSON.stringify(res) }],
+    success: true,
+  };
+};

package/src/tools/routine.ts

@@ -0,0 +1,130 @@
+import { CallToolRequest, Tool } from '@modelcontextprotocol/sdk/types.js';
+import api from '../utils/service.js';
+import {
+  CreateRoutineRequest,
+  DeleteRoutineRequest,
+  GetRoutineRequest,
+} from '@alicloud/esa20240910';
+
+export const ROUTINE_CREATE_TOOL: Tool = {
+  name: 'routine_create',
+  description: 'Create a edge routine(ER).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description:
+          'The name of the routine, support lowercase English, numbers, and hyphens, must start with lowercase English, length cannot be less than 2 characters',
+      },
+      description: {
+        type: 'string',
+        description: 'Description of the routine, no spaces',
+      },
+      code: {
+        type: 'string',
+        description:
+          'Source Code of the routine, export default { async fetch(request) { return handleRequest(request); } }',
+      },
+    },
+    required: ['name', 'code'],
+  },
+};
+
+export const ROUTINE_DELETE_TOOL: Tool = {
+  name: 'routine_delete',
+  description: 'Delete a edge routine(ER).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'The name of the routine to delete',
+      },
+    },
+    required: ['name'],
+  },
+};
+
+export const ROUTINE_LIST_TOOL: Tool = {
+  name: 'routine_list',
+  description: 'List all edge routines',
+  inputSchema: {
+    type: 'object',
+    properties: {},
+  },
+};
+
+export const ROUTINE_GET_TOOL: Tool = {
+  name: 'routine_get',
+  description: 'Get a edge routine detail by name',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'The name of the routine to get details for',
+      },
+    },
+    required: ['name'],
+  },
+};
+
+export const routine_create = async (request: CallToolRequest) => {
+  const res = await api.createRoutine(
+    request.params.arguments as CreateRoutineRequest,
+  );
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(res),
+      },
+    ],
+    success: true,
+  };
+};
+
+export const routine_delete = async (request: CallToolRequest) => {
+  const res = await api.deleteRoutine(
+    request.params.arguments as DeleteRoutineRequest,
+  );
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(res),
+      },
+    ],
+    success: true,
+  };
+};
+
+export const routine_list = async () => {
+  const res = await api.getRoutineUserInfo();
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(res),
+      },
+    ],
+    success: true,
+  };
+};
+
+export const routine_get = async (request: CallToolRequest) => {
+  const res = await api.getRoutine(
+    request.params.arguments as GetRoutineRequest,
+  );
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(res),
+      },
+    ],
+    success: true,
+  };
+};

package/src/tools/site.ts

@@ -0,0 +1,61 @@
+import { CallToolRequest, Tool } from '@modelcontextprotocol/sdk/types.js';
+import api from '../utils/service.js';
+import { ListSitesRequest } from '@alicloud/esa20240910';
+import { GetMatchSiteRequest } from '../utils/types.js';
+
+export const SITE_ACTIVE_LIST_TOOL: Tool = {
+  name: 'site_active_list',
+  description: 'List all active sites',
+  inputSchema: {
+    type: 'object',
+    properties: {},
+  },
+};
+
+export const SITE_MATCH_TOOL: Tool = {
+  name: 'site_match',
+  description: 'Check which site under the account matches the user input',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      recordName: {
+        type: 'string',
+        description: 'The name of the site to match',
+      },
+    },
+    required: ['recordName'],
+  },
+};
+
+export const site_active_list = async () => {
+  const res = await api.listSites({
+    siteSearchType: 'fuzzy',
+    status: 'active',
+    pageNumber: 1,
+    pageSize: 500,
+  } as ListSitesRequest);
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(res),
+      },
+    ],
+    success: true,
+  };
+};
+
+export const site_match = async (request: CallToolRequest) => {
+  const res = await api.getMatchSite({
+    recordName: request.params.arguments?.recordName ?? '',
+  } as GetMatchSiteRequest);
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(res),
+      },
+    ],
+    success: true,
+  };
+};