Files
MikrotikManager/backend/src/modules/mcp/registry.ts
T

60 lines
5.6 KiB
TypeScript

import { mcpOperationDescriptorSchema, type McpOperationDescriptor } from "@mmapp/contracts/mcp"
type Definition = Pick<McpOperationDescriptor, "id" | "toolName" | "title" | "section" | "effect" | "risk" | "scope" | "requiredPermissions">
// Baseline planned definitions. Typed runtime actions promote implemented entries.
// Adding a definition never grants it to an existing connection.
const definitions: Definition[] = [
{ id: "capabilities.read", toolName: "mm_capabilities_get", title: "Доступные возможности", section: "mcp", effect: "read", risk: "ordinary", scope: "connection", requiredPermissions: [] },
{ id: "servers.list", toolName: "mm_servers_list", title: "Каталог серверов", section: "servers", effect: "read", risk: "ordinary", scope: "servers", requiredPermissions: ["mm:servers:read"] },
{ id: "users.list", toolName: "mm_users_list", title: "Каталог пользователей", section: "users", effect: "read", risk: "ordinary", scope: "global", requiredPermissions: ["mm:users:read"] },
{ id: "users.create", toolName: "mm_users_create_plan", title: "Создание пользователя", section: "users", effect: "write", risk: "ordinary", scope: "global", requiredPermissions: ["mm:users:write"] },
{ id: "users.permissions.update", toolName: "mm_users_permissions_update_plan", title: "Изменение прав пользователя", section: "users", effect: "write", risk: "dangerous", scope: "global", requiredPermissions: ["mm:settings:admin"] },
{ id: "logs.query", toolName: "mm_logs_query", title: "Поиск логов", section: "logs", effect: "read", risk: "ordinary", scope: "servers", requiredPermissions: ["mm:servers:read"] },
{ id: "logs.context", toolName: "mm_logs_context_get", title: "Контекст события", section: "logs", effect: "read", risk: "ordinary", scope: "servers", requiredPermissions: ["mm:servers:read"] },
{ id: "logs.follow", toolName: "mm_logs_follow", title: "Ожидание новых логов", section: "logs", effect: "read", risk: "ordinary", scope: "servers", requiredPermissions: ["mm:servers:read"] },
{ id: "logs.settings.update", toolName: "mm_logs_settings_update_plan", title: "Настройки сборщика логов", section: "logs", effect: "write", risk: "dangerous", scope: "global", requiredPermissions: ["mm:settings:admin"] },
{ id: "routing.analyze", toolName: "mm_route_optimizer_analyze", title: "Анализ маршрутизации", section: "network", effect: "read", risk: "ordinary", scope: "servers", requiredPermissions: ["mm:network:read"] },
{ id: "routing.ospf.optimize", toolName: "mm_ospf_optimizer_plan", title: "Оптимизация OSPF", section: "network", effect: "write", risk: "dangerous", scope: "servers", requiredPermissions: ["mm:network:write"] },
{ id: "routing.ecmp.update", toolName: "mm_ecmp_plan", title: "Настройка ECMP", section: "network", effect: "write", risk: "dangerous", scope: "servers", requiredPermissions: ["mm:network:write"] },
{ id: "routing.vrf.update", toolName: "mm_vrf_plan", title: "Настройка VRF", section: "network", effect: "write", risk: "dangerous", scope: "servers", requiredPermissions: ["mm:network:write"] },
{ id: "interfaces.update", toolName: "mm_interfaces_update_plan", title: "Настройка интерфейса", section: "network", effect: "write", risk: "dangerous", scope: "servers", requiredPermissions: ["mm:network:write"] },
{ id: "firewall.update", toolName: "mm_firewall_rule_update_plan", title: "Настройка firewall", section: "network", effect: "write", risk: "dangerous", scope: "servers", requiredPermissions: ["mm:network:write"] },
{ id: "diagnostics.bandwidth", toolName: "mm_routing_measurement_plan", title: "Нагрузочный bandwidth-тест", section: "network", effect: "diagnostic", risk: "dangerous", scope: "servers", requiredPermissions: ["mm:network:write"] },
{ id: "database.restore", toolName: "mm_database_restore_plan", title: "Восстановление базы приложения", section: "settings", effect: "write", risk: "dangerous", scope: "global", requiredPermissions: ["mm:settings:admin"] },
]
const registry = definitions.map(definition => mcpOperationDescriptorSchema.parse({
...definition,
version: 1,
implementation: "planned",
annotations: {
readOnlyHint: definition.effect === "read",
destructiveHint: definition.effect === "write",
idempotentHint: definition.effect === "read",
openWorldHint: true,
},
}))
if (new Set(registry.map(operation => operation.id)).size !== registry.length ||
new Set(registry.map(operation => operation.toolName)).size !== registry.length) {
throw new Error("Повторяющиеся операции MCP")
}
// Return copies so callers cannot mutate trusted policy metadata.
export function listMcpOperations(): McpOperationDescriptor[] {
return registry.map(operation => mcpOperationDescriptorSchema.parse(operation))
}
export function findMcpOperation(id: string): McpOperationDescriptor | undefined {
const operation = registry.find(candidate => candidate.id === id)
return operation ? mcpOperationDescriptorSchema.parse(operation) : undefined
}
export function registerMcpOperation(operation: McpOperationDescriptor): void {
const parsed = mcpOperationDescriptorSchema.parse(operation)
const existing = registry.findIndex(candidate => candidate.id === parsed.id)
if (registry.some((candidate, index) => index !== existing && candidate.toolName === parsed.toolName)) throw new Error("Повторяющееся имя инструмента MCP")
if (existing >= 0) registry[existing] = parsed
else registry.push(parsed)
}