opc-agent 2.0.2 → 3.0.0

package/src/mcp/servers/crypto-mcp.ts

@@ -0,0 +1,73 @@
+import * as crypto from 'crypto';
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+export function createCryptoServer(): MCPServerConfig {
+  return {
+    name: 'crypto',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'crypto_hash',
+        description: 'Generate hash of input text (md5, sha1, sha256, sha512)',
+        inputSchema: { type: 'object', properties: { text: { type: 'string' }, algorithm: { type: 'string', enum: ['md5', 'sha1', 'sha256', 'sha512'], default: 'sha256' } }, required: ['text'] },
+        handler: async (args: { text: string; algorithm?: string }) => {
+          const hash = crypto.createHash(args.algorithm || 'sha256').update(args.text).digest('hex');
+          return { hash, algorithm: args.algorithm || 'sha256' };
+        },
+      },
+      {
+        name: 'crypto_hmac',
+        description: 'Generate HMAC signature',
+        inputSchema: { type: 'object', properties: { text: { type: 'string' }, key: { type: 'string' }, algorithm: { type: 'string', default: 'sha256' } }, required: ['text', 'key'] },
+        handler: async (args: { text: string; key: string; algorithm?: string }) => {
+          const hmac = crypto.createHmac(args.algorithm || 'sha256', args.key).update(args.text).digest('hex');
+          return { hmac, algorithm: args.algorithm || 'sha256' };
+        },
+      },
+      {
+        name: 'crypto_random',
+        description: 'Generate random bytes, UUID, or random number',
+        inputSchema: { type: 'object', properties: { type: { type: 'string', enum: ['bytes', 'uuid', 'number'], default: 'uuid' }, length: { type: 'number', default: 32 }, min: { type: 'number' }, max: { type: 'number' } }, required: [] },
+        handler: async (args: { type?: string; length?: number; min?: number; max?: number }) => {
+          switch (args.type || 'uuid') {
+            case 'bytes': return { value: crypto.randomBytes(args.length || 32).toString('hex') };
+            case 'uuid': return { value: crypto.randomUUID() };
+            case 'number': {
+              const min = args.min ?? 0;
+              const max = args.max ?? 100;
+              return { value: min + Math.floor(Math.random() * (max - min + 1)) };
+            }
+            default: throw new Error('Unknown type');
+          }
+        },
+      },
+      {
+        name: 'crypto_encrypt',
+        description: 'Encrypt text with AES-256-GCM',
+        inputSchema: { type: 'object', properties: { text: { type: 'string' }, password: { type: 'string' } }, required: ['text', 'password'] },
+        handler: async (args: { text: string; password: string }) => {
+          const key = crypto.scryptSync(args.password, 'opc-salt', 32);
+          const iv = crypto.randomBytes(16);
+          const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
+          let encrypted = cipher.update(args.text, 'utf8', 'hex');
+          encrypted += cipher.final('hex');
+          const tag = cipher.getAuthTag().toString('hex');
+          return { encrypted, iv: iv.toString('hex'), tag };
+        },
+      },
+      {
+        name: 'crypto_decrypt',
+        description: 'Decrypt AES-256-GCM encrypted text',
+        inputSchema: { type: 'object', properties: { encrypted: { type: 'string' }, password: { type: 'string' }, iv: { type: 'string' }, tag: { type: 'string' } }, required: ['encrypted', 'password', 'iv', 'tag'] },
+        handler: async (args: { encrypted: string; password: string; iv: string; tag: string }) => {
+          const key = crypto.scryptSync(args.password, 'opc-salt', 32);
+          const decipher = crypto.createDecipheriv('aes-256-gcm', key, Buffer.from(args.iv, 'hex'));
+          decipher.setAuthTag(Buffer.from(args.tag, 'hex'));
+          let decrypted = decipher.update(args.encrypted, 'hex', 'utf8');
+          decrypted += decipher.final('utf8');
+          return { decrypted };
+        },
+      },
+    ],
+  };
+}

package/src/mcp/servers/database-mcp.ts

@@ -0,0 +1,72 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+// In-memory SQL-like database (no external deps)
+interface Table { columns: string[]; rows: any[][] }
+
+export function createDatabaseServer(): MCPServerConfig {
+  const tables = new Map<string, Table>();
+
+  return {
+    name: 'database',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'db_create_table',
+        description: 'Create a table with specified columns',
+        inputSchema: { type: 'object', properties: { table: { type: 'string' }, columns: { type: 'array', items: { type: 'string' } } }, required: ['table', 'columns'] },
+        handler: async (args: { table: string; columns: string[] }) => {
+          tables.set(args.table, { columns: args.columns, rows: [] });
+          return { created: args.table, columns: args.columns };
+        },
+      },
+      {
+        name: 'db_insert',
+        description: 'Insert a row into a table',
+        inputSchema: { type: 'object', properties: { table: { type: 'string' }, values: { type: 'object' } }, required: ['table', 'values'] },
+        handler: async (args: { table: string; values: Record<string, any> }) => {
+          const t = tables.get(args.table);
+          if (!t) throw new Error(`Table ${args.table} not found`);
+          const row = t.columns.map(c => args.values[c] ?? null);
+          t.rows.push(row);
+          return { inserted: true, rowIndex: t.rows.length - 1 };
+        },
+      },
+      {
+        name: 'db_query',
+        description: 'Query a table with optional where clause',
+        inputSchema: { type: 'object', properties: { table: { type: 'string' }, where: { type: 'object' }, limit: { type: 'number' } }, required: ['table'] },
+        handler: async (args: { table: string; where?: Record<string, any>; limit?: number }) => {
+          const t = tables.get(args.table);
+          if (!t) throw new Error(`Table ${args.table} not found`);
+          let results = t.rows.map(row => {
+            const obj: Record<string, any> = {};
+            t.columns.forEach((c, i) => obj[c] = row[i]);
+            return obj;
+          });
+          if (args.where) {
+            results = results.filter(row => Object.entries(args.where!).every(([k, v]) => row[k] === v));
+          }
+          if (args.limit) results = results.slice(0, args.limit);
+          return { rows: results, count: results.length };
+        },
+      },
+      {
+        name: 'db_list_tables',
+        description: 'List all tables',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => {
+          return { tables: Array.from(tables.entries()).map(([name, t]) => ({ name, columns: t.columns, rowCount: t.rows.length })) };
+        },
+      },
+      {
+        name: 'db_drop_table',
+        description: 'Drop a table',
+        inputSchema: { type: 'object', properties: { table: { type: 'string' } }, required: ['table'] },
+        handler: async (args: { table: string }) => {
+          const existed = tables.delete(args.table);
+          return { dropped: existed };
+        },
+      },
+    ],
+  };
+}

package/src/mcp/servers/datetime-mcp.ts

@@ -0,0 +1,69 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+const TIMEZONE_OFFSETS: Record<string, number> = {
+  'UTC': 0, 'GMT': 0, 'EST': -5, 'EDT': -4, 'CST': -6, 'CDT': -5,
+  'MST': -7, 'MDT': -6, 'PST': -8, 'PDT': -7, 'JST': 9, 'KST': 9,
+  'CST8': 8, 'IST': 5.5, 'CET': 1, 'CEST': 2, 'AEST': 10, 'AEDT': 11,
+  'Asia/Shanghai': 8, 'Asia/Tokyo': 9, 'America/New_York': -4,
+  'America/Los_Angeles': -7, 'Europe/London': 1, 'Europe/Berlin': 2,
+};
+
+export function createDateTimeServer(): MCPServerConfig {
+  return {
+    name: 'datetime',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'dt_now',
+        description: 'Get current date/time in a timezone',
+        inputSchema: { type: 'object', properties: { timezone: { type: 'string', default: 'UTC' }, format: { type: 'string', enum: ['iso', 'unix', 'human'], default: 'iso' } } },
+        handler: async (args: { timezone?: string; format?: string }) => {
+          const offset = TIMEZONE_OFFSETS[args.timezone || 'UTC'] ?? 0;
+          const now = new Date(Date.now() + offset * 3600000);
+          const fmt = args.format || 'iso';
+          return {
+            iso: now.toISOString(),
+            unix: Math.floor(now.getTime() / 1000),
+            human: now.toUTCString(),
+            timezone: args.timezone || 'UTC',
+            offset,
+          };
+        },
+      },
+      {
+        name: 'dt_diff',
+        description: 'Calculate difference between two dates',
+        inputSchema: { type: 'object', properties: { from: { type: 'string' }, to: { type: 'string' }, unit: { type: 'string', enum: ['days', 'hours', 'minutes', 'seconds'], default: 'days' } }, required: ['from', 'to'] },
+        handler: async (args: { from: string; to: string; unit?: string }) => {
+          const d1 = new Date(args.from).getTime();
+          const d2 = new Date(args.to).getTime();
+          const diffMs = d2 - d1;
+          const divisors: Record<string, number> = { seconds: 1000, minutes: 60000, hours: 3600000, days: 86400000 };
+          const unit = args.unit || 'days';
+          return { from: args.from, to: args.to, difference: diffMs / divisors[unit], unit };
+        },
+      },
+      {
+        name: 'dt_add',
+        description: 'Add duration to a date',
+        inputSchema: { type: 'object', properties: { date: { type: 'string' }, amount: { type: 'number' }, unit: { type: 'string', enum: ['days', 'hours', 'minutes', 'seconds'] } }, required: ['date', 'amount', 'unit'] },
+        handler: async (args: { date: string; amount: number; unit: string }) => {
+          const d = new Date(args.date);
+          const ms: Record<string, number> = { seconds: 1000, minutes: 60000, hours: 3600000, days: 86400000 };
+          const result = new Date(d.getTime() + args.amount * ms[args.unit]);
+          return { original: args.date, result: result.toISOString(), added: `${args.amount} ${args.unit}` };
+        },
+      },
+      {
+        name: 'dt_parse',
+        description: 'Parse a date string and return components',
+        inputSchema: { type: 'object', properties: { date: { type: 'string' } }, required: ['date'] },
+        handler: async (args: { date: string }) => {
+          const d = new Date(args.date);
+          if (isNaN(d.getTime())) throw new Error('Invalid date');
+          return { iso: d.toISOString(), year: d.getFullYear(), month: d.getMonth() + 1, day: d.getDate(), dayOfWeek: d.toLocaleDateString('en', { weekday: 'long' }), unix: Math.floor(d.getTime() / 1000) };
+        },
+      },
+    ],
+  };
+}

package/src/mcp/servers/filesystem.ts

@@ -0,0 +1,66 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+export function createFilesystemServer(rootDir: string = process.cwd()): MCPServerConfig {
+  const resolve = (p: string) => {
+    const resolved = path.resolve(rootDir, p);
+    if (!resolved.startsWith(path.resolve(rootDir))) throw new Error('Path traversal not allowed');
+    return resolved;
+  };
+
+  return {
+    name: 'filesystem',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'fs_read',
+        description: 'Read file contents as UTF-8 text',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'File path relative to root' } }, required: ['path'] },
+        handler: async (args: { path: string }) => {
+          return { content: fs.readFileSync(resolve(args.path), 'utf-8') };
+        },
+      },
+      {
+        name: 'fs_write',
+        description: 'Write content to a file (creates directories as needed)',
+        inputSchema: { type: 'object', properties: { path: { type: 'string' }, content: { type: 'string' } }, required: ['path', 'content'] },
+        handler: async (args: { path: string; content: string }) => {
+          const target = resolve(args.path);
+          fs.mkdirSync(path.dirname(target), { recursive: true });
+          fs.writeFileSync(target, args.content, 'utf-8');
+          return { written: target };
+        },
+      },
+      {
+        name: 'fs_list',
+        description: 'List files and directories',
+        inputSchema: { type: 'object', properties: { path: { type: 'string', default: '.' }, recursive: { type: 'boolean', default: false } }, required: [] },
+        handler: async (args: { path?: string; recursive?: boolean }) => {
+          const dir = resolve(args.path || '.');
+          const entries = fs.readdirSync(dir, { withFileTypes: true });
+          const result = entries.map(e => ({ name: e.name, type: e.isDirectory() ? 'directory' : 'file' }));
+          return { entries: result };
+        },
+      },
+      {
+        name: 'fs_stat',
+        description: 'Get file/directory metadata',
+        inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+        handler: async (args: { path: string }) => {
+          const stat = fs.statSync(resolve(args.path));
+          return { size: stat.size, isFile: stat.isFile(), isDirectory: stat.isDirectory(), modified: stat.mtime.toISOString() };
+        },
+      },
+      {
+        name: 'fs_delete',
+        description: 'Delete a file',
+        inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+        handler: async (args: { path: string }) => {
+          fs.unlinkSync(resolve(args.path));
+          return { deleted: true };
+        },
+      },
+    ],
+  };
+}

package/src/mcp/servers/github-mcp.ts

@@ -0,0 +1,58 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+export function createGitHubServer(token?: string): MCPServerConfig {
+  const headers: Record<string, string> = {
+    'Accept': 'application/vnd.github.v3+json',
+    'User-Agent': 'opc-mcp-github/1.0',
+  };
+  if (token) headers['Authorization'] = `Bearer ${token}`;
+
+  const ghFetch = async (path: string, opts: any = {}) => {
+    const res = await fetch(`https://api.github.com${path}`, { ...opts, headers: { ...headers, ...opts.headers } });
+    if (!res.ok) throw new Error(`GitHub API ${res.status}: ${await res.text()}`);
+    return res.json();
+  };
+
+  return {
+    name: 'github',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'github_get_repo',
+        description: 'Get repository information',
+        inputSchema: { type: 'object', properties: { owner: { type: 'string' }, repo: { type: 'string' } }, required: ['owner', 'repo'] },
+        handler: async (args: { owner: string; repo: string }) => ghFetch(`/repos/${args.owner}/${args.repo}`),
+      },
+      {
+        name: 'github_list_issues',
+        description: 'List repository issues',
+        inputSchema: { type: 'object', properties: { owner: { type: 'string' }, repo: { type: 'string' }, state: { type: 'string', enum: ['open', 'closed', 'all'], default: 'open' } }, required: ['owner', 'repo'] },
+        handler: async (args: { owner: string; repo: string; state?: string }) => ghFetch(`/repos/${args.owner}/${args.repo}/issues?state=${args.state || 'open'}`),
+      },
+      {
+        name: 'github_create_issue',
+        description: 'Create a new issue',
+        inputSchema: { type: 'object', properties: { owner: { type: 'string' }, repo: { type: 'string' }, title: { type: 'string' }, body: { type: 'string' } }, required: ['owner', 'repo', 'title'] },
+        handler: async (args: { owner: string; repo: string; title: string; body?: string }) =>
+          ghFetch(`/repos/${args.owner}/${args.repo}/issues`, { method: 'POST', body: JSON.stringify({ title: args.title, body: args.body }), headers: { 'Content-Type': 'application/json' } }),
+      },
+      {
+        name: 'github_search_repos',
+        description: 'Search GitHub repositories',
+        inputSchema: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'] },
+        handler: async (args: { query: string }) => ghFetch(`/search/repositories?q=${encodeURIComponent(args.query)}`),
+      },
+      {
+        name: 'github_get_file',
+        description: 'Get file contents from a repository',
+        inputSchema: { type: 'object', properties: { owner: { type: 'string' }, repo: { type: 'string' }, path: { type: 'string' }, ref: { type: 'string' } }, required: ['owner', 'repo', 'path'] },
+        handler: async (args: { owner: string; repo: string; path: string; ref?: string }) => {
+          const q = args.ref ? `?ref=${args.ref}` : '';
+          const data: any = await ghFetch(`/repos/${args.owner}/${args.repo}/contents/${args.path}${q}`);
+          if (data.content) data.decoded = Buffer.from(data.content, 'base64').toString('utf-8');
+          return data;
+        },
+      },
+    ],
+  };
+}

package/src/mcp/servers/index.ts

@@ -0,0 +1,63 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+import { createFilesystemServer } from './filesystem';
+import { createGitHubServer } from './github-mcp';
+import { createDatabaseServer } from './database-mcp';
+import { createWebServer } from './web-mcp';
+import { createMemoryServer } from './memory-mcp';
+import { createCalculatorServer } from './calculator-mcp';
+import { createDateTimeServer } from './datetime-mcp';
+import { createJsonServer } from './json-mcp';
+import { createRegexServer } from './regex-mcp';
+import { createCryptoServer } from './crypto-mcp';
+
+export interface MCPServerInfo {
+  name: string;
+  description: string;
+  version: string;
+  toolCount: number;
+}
+
+interface ServerEntry {
+  name: string;
+  description: string;
+  factory: () => MCPServerConfig;
+}
+
+const SERVERS: ServerEntry[] = [
+  { name: 'filesystem', description: 'Read/write/list files in a sandboxed directory', factory: () => createFilesystemServer() },
+  { name: 'github', description: 'GitHub API — repos, issues, files via fetch', factory: () => createGitHubServer() },
+  { name: 'database', description: 'In-memory SQL-like database with tables and queries', factory: () => createDatabaseServer() },
+  { name: 'web', description: 'Web fetch, text extraction, and search', factory: () => createWebServer() },
+  { name: 'memory', description: 'Key-value memory store with tags and search', factory: () => createMemoryServer() },
+  { name: 'calculator', description: 'Math evaluation, unit conversion, percentages', factory: () => createCalculatorServer() },
+  { name: 'datetime', description: 'Time zones, date math, parsing, and formatting', factory: () => createDateTimeServer() },
+  { name: 'json', description: 'JSON path query, transform, validate, and diff', factory: () => createJsonServer() },
+  { name: 'regex', description: 'Regex test, match, replace, and split', factory: () => createRegexServer() },
+  { name: 'crypto', description: 'Hash, HMAC, encrypt/decrypt, random generation', factory: () => createCryptoServer() },
+];
+
+export function getMCPServer(name: string): MCPServerConfig {
+  const entry = SERVERS.find(s => s.name === name);
+  if (!entry) throw new Error(`MCP server '${name}' not found. Available: ${SERVERS.map(s => s.name).join(', ')}`);
+  return entry.factory();
+}
+
+export function listMCPServers(): MCPServerInfo[] {
+  return SERVERS.map(s => {
+    const config = s.factory();
+    return { name: s.name, description: s.description, version: config.version, toolCount: config.tools?.length || 0 };
+  });
+}
+
+export {
+  createFilesystemServer,
+  createGitHubServer,
+  createDatabaseServer,
+  createWebServer,
+  createMemoryServer,
+  createCalculatorServer,
+  createDateTimeServer,
+  createJsonServer,
+  createRegexServer,
+  createCryptoServer,
+};

package/src/mcp/servers/json-mcp.ts

@@ -0,0 +1,102 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+function jsonPathQuery(obj: any, path: string): any[] {
+  const parts = path.replace(/^\$\.?/, '').split('.');
+  let current: any[] = [obj];
+  for (const part of parts) {
+    if (!part) continue;
+    const next: any[] = [];
+    for (const item of current) {
+      if (part === '*') {
+        if (Array.isArray(item)) next.push(...item);
+        else if (typeof item === 'object' && item) next.push(...Object.values(item));
+      } else if (part.match(/^\[(\d+)\]$/)) {
+        const idx = parseInt(part.slice(1, -1));
+        if (Array.isArray(item) && item[idx] !== undefined) next.push(item[idx]);
+      } else {
+        if (item && typeof item === 'object' && part in item) next.push(item[part]);
+      }
+    }
+    current = next;
+  }
+  return current;
+}
+
+export function createJsonServer(): MCPServerConfig {
+  return {
+    name: 'json',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'json_query',
+        description: 'Query JSON data using dot-notation path (e.g. "users.0.name", "items.*")',
+        inputSchema: { type: 'object', properties: { data: { description: 'JSON string or object' }, path: { type: 'string', description: 'Dot-notation path' } }, required: ['data', 'path'] },
+        handler: async (args: { data: any; path: string }) => {
+          const obj = typeof args.data === 'string' ? JSON.parse(args.data) : args.data;
+          return { results: jsonPathQuery(obj, args.path) };
+        },
+      },
+      {
+        name: 'json_transform',
+        description: 'Transform JSON: pick fields, rename keys, flatten',
+        inputSchema: { type: 'object', properties: { data: {}, operation: { type: 'string', enum: ['pick', 'omit', 'flatten', 'keys', 'values'] }, fields: { type: 'array', items: { type: 'string' } } }, required: ['data', 'operation'] },
+        handler: async (args: { data: any; operation: string; fields?: string[] }) => {
+          const obj = typeof args.data === 'string' ? JSON.parse(args.data) : args.data;
+          switch (args.operation) {
+            case 'pick': {
+              const result: any = {};
+              for (const f of args.fields || []) if (f in obj) result[f] = obj[f];
+              return { result };
+            }
+            case 'omit': {
+              const result = { ...obj };
+              for (const f of args.fields || []) delete result[f];
+              return { result };
+            }
+            case 'flatten': {
+              const result: Record<string, any> = {};
+              const recurse = (o: any, prefix: string) => {
+                for (const [k, v] of Object.entries(o)) {
+                  const key = prefix ? `${prefix}.${k}` : k;
+                  if (v && typeof v === 'object' && !Array.isArray(v)) recurse(v, key);
+                  else result[key] = v;
+                }
+              };
+              recurse(obj, '');
+              return { result };
+            }
+            case 'keys': return { result: Object.keys(obj) };
+            case 'values': return { result: Object.values(obj) };
+            default: throw new Error(`Unknown operation: ${args.operation}`);
+          }
+        },
+      },
+      {
+        name: 'json_validate',
+        description: 'Check if a string is valid JSON',
+        inputSchema: { type: 'object', properties: { data: { type: 'string' } }, required: ['data'] },
+        handler: async (args: { data: string }) => {
+          try { JSON.parse(args.data); return { valid: true }; } catch (e: any) { return { valid: false, error: e.message }; }
+        },
+      },
+      {
+        name: 'json_diff',
+        description: 'Compare two JSON objects and return differences',
+        inputSchema: { type: 'object', properties: { a: {}, b: {} }, required: ['a', 'b'] },
+        handler: async (args: { a: any; b: any }) => {
+          const a = typeof args.a === 'string' ? JSON.parse(args.a) : args.a;
+          const b = typeof args.b === 'string' ? JSON.parse(args.b) : args.b;
+          const diffs: { path: string; a: any; b: any }[] = [];
+          const compare = (x: any, y: any, path: string) => {
+            if (x === y) return;
+            if (typeof x !== typeof y || typeof x !== 'object' || !x || !y) { diffs.push({ path, a: x, b: y }); return; }
+            const keys = new Set([...Object.keys(x), ...Object.keys(y)]);
+            for (const k of keys) compare(x[k], y[k], path ? `${path}.${k}` : k);
+          };
+          compare(a, b, '');
+          return { equal: diffs.length === 0, differences: diffs };
+        },
+      },
+    ],
+  };
+}

package/src/mcp/servers/memory-mcp.ts

@@ -0,0 +1,56 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+export function createMemoryServer(): MCPServerConfig {
+  const store = new Map<string, { value: any; tags: string[]; created: string; updated: string }>();
+
+  return {
+    name: 'memory',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'memory_store',
+        description: 'Store a key-value pair in memory with optional tags',
+        inputSchema: { type: 'object', properties: { key: { type: 'string' }, value: { type: 'any' }, tags: { type: 'array', items: { type: 'string' } } }, required: ['key', 'value'] },
+        handler: async (args: { key: string; value: any; tags?: string[] }) => {
+          const now = new Date().toISOString();
+          const existing = store.get(args.key);
+          store.set(args.key, { value: args.value, tags: args.tags || [], created: existing?.created || now, updated: now });
+          return { stored: args.key };
+        },
+      },
+      {
+        name: 'memory_recall',
+        description: 'Recall a value by key',
+        inputSchema: { type: 'object', properties: { key: { type: 'string' } }, required: ['key'] },
+        handler: async (args: { key: string }) => {
+          const entry = store.get(args.key);
+          if (!entry) return { found: false };
+          return { found: true, ...entry };
+        },
+      },
+      {
+        name: 'memory_search',
+        description: 'Search memory entries by tag or substring in key',
+        inputSchema: { type: 'object', properties: { query: { type: 'string' }, tag: { type: 'string' } }, required: [] },
+        handler: async (args: { query?: string; tag?: string }) => {
+          let results = Array.from(store.entries()).map(([k, v]) => ({ key: k, ...v }));
+          if (args.tag) results = results.filter(r => r.tags.includes(args.tag!));
+          if (args.query) results = results.filter(r => r.key.includes(args.query!) || JSON.stringify(r.value).includes(args.query!));
+          return { results, count: results.length };
+        },
+      },
+      {
+        name: 'memory_delete',
+        description: 'Delete a memory entry',
+        inputSchema: { type: 'object', properties: { key: { type: 'string' } }, required: ['key'] },
+        handler: async (args: { key: string }) => ({ deleted: store.delete(args.key) }),
+      },
+      {
+        name: 'memory_list',
+        description: 'List all memory keys',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => ({ keys: Array.from(store.keys()), count: store.size }),
+      },
+    ],
+  };
+}

package/src/mcp/servers/regex-mcp.ts

@@ -0,0 +1,53 @@
+import type { MCPServerConfig } from '../../protocols/mcp/types';
+
+export function createRegexServer(): MCPServerConfig {
+  return {
+    name: 'regex',
+    version: '1.0.0',
+    tools: [
+      {
+        name: 'regex_test',
+        description: 'Test if a string matches a regex pattern',
+        inputSchema: { type: 'object', properties: { pattern: { type: 'string' }, flags: { type: 'string', default: '' }, text: { type: 'string' } }, required: ['pattern', 'text'] },
+        handler: async (args: { pattern: string; flags?: string; text: string }) => {
+          const re = new RegExp(args.pattern, args.flags || '');
+          return { matches: re.test(args.text), pattern: args.pattern };
+        },
+      },
+      {
+        name: 'regex_match',
+        description: 'Find all matches of a regex in text',
+        inputSchema: { type: 'object', properties: { pattern: { type: 'string' }, flags: { type: 'string', default: 'g' }, text: { type: 'string' } }, required: ['pattern', 'text'] },
+        handler: async (args: { pattern: string; flags?: string; text: string }) => {
+          const re = new RegExp(args.pattern, args.flags || 'g');
+          const matches: { match: string; index: number; groups?: Record<string, string> }[] = [];
+          let m;
+          while ((m = re.exec(args.text)) !== null) {
+            matches.push({ match: m[0], index: m.index, groups: m.groups });
+            if (!re.global) break;
+          }
+          return { matches, count: matches.length };
+        },
+      },
+      {
+        name: 'regex_replace',
+        description: 'Replace matches in text using regex',
+        inputSchema: { type: 'object', properties: { pattern: { type: 'string' }, flags: { type: 'string', default: 'g' }, text: { type: 'string' }, replacement: { type: 'string' } }, required: ['pattern', 'text', 'replacement'] },
+        handler: async (args: { pattern: string; flags?: string; text: string; replacement: string }) => {
+          const re = new RegExp(args.pattern, args.flags || 'g');
+          return { result: args.text.replace(re, args.replacement) };
+        },
+      },
+      {
+        name: 'regex_split',
+        description: 'Split text by regex pattern',
+        inputSchema: { type: 'object', properties: { pattern: { type: 'string' }, text: { type: 'string' }, limit: { type: 'number' } }, required: ['pattern', 'text'] },
+        handler: async (args: { pattern: string; text: string; limit?: number }) => {
+          const re = new RegExp(args.pattern);
+          const parts = args.text.split(re, args.limit);
+          return { parts, count: parts.length };
+        },
+      },
+    ],
+  };
+}