feat: mcpctl v0.0.1 — first public release

Comprehensive MCP server management with kubectl-style CLI.

Key features in this release:
- Declarative YAML apply/get round-trip with project cloning support
- Gated sessions with prompt intelligence for Claude
- Interactive MCP console with traffic inspector
- Persistent STDIO connections for containerized servers
- RBAC with name-scoped bindings
- Shell completions (fish + bash) auto-generated
- Rate-limit retry with exponential backoff in apply
- Project-scoped prompt management
- Credential scrubbing from git history

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/db/tests/global-setup.ts

@@ -0,0 +1,20 @@
+/**
+ * Vitest globalSetup: push schema once before all db tests.
+ * Runs in the main vitest process, outside test workers.
+ */
+import { execSync } from 'node:child_process';
+
+const TEST_DATABASE_URL = process.env['DATABASE_URL'] ??
+  'postgresql://mcpctl:mcpctl_test@localhost:5433/mcpctl_test';
+
+export function setup(): void {
+  execSync('npx prisma db push --force-reset --skip-generate', {
+    cwd: new URL('..', import.meta.url).pathname,
+    env: {
+      ...process.env,
+      DATABASE_URL: TEST_DATABASE_URL,
+      PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION: 'yes',
+    },
+    stdio: 'pipe',
+  });
+}

src/db/tests/helpers.ts

@@ -1,11 +1,9 @@
 import { PrismaClient } from '@prisma/client';
-import { execSync } from 'node:child_process';
 
 const TEST_DATABASE_URL = process.env['DATABASE_URL'] ??
   'postgresql://mcpctl:mcpctl_test@localhost:5433/mcpctl_test';
 
 let prisma: PrismaClient | undefined;
-let schemaReady = false;
 
 export function getTestClient(): PrismaClient {
   if (!prisma) {
@@ -16,26 +14,9 @@ export function getTestClient(): PrismaClient {
   return prisma;
 }
 
+/** Return a connected test client. Schema is pushed by globalSetup. */
 export async function setupTestDb(): Promise<PrismaClient> {
-  const client = getTestClient();
-
-  // Only push schema once per process (multiple test files share the worker)
-  if (!schemaReady) {
-    execSync('npx prisma db push --force-reset --skip-generate', {
-      cwd: new URL('..', import.meta.url).pathname,
-      env: {
-        ...process.env,
-        DATABASE_URL: TEST_DATABASE_URL,
-        // Consent required when Prisma detects AI agent context.
-        // This targets the ephemeral test database (tmpfs-backed, port 5433).
-        PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION: 'yes',
-      },
-      stdio: 'pipe',
-    });
-    schemaReady = true;
-  }
-
-  return client;
+  return getTestClient();
 }
 
 export async function cleanupTestDb(): Promise<void> {
@@ -49,8 +30,9 @@ export async function clearAllTables(client: PrismaClient): Promise<void> {
   // Delete in order respecting foreign keys
   await client.auditLog.deleteMany();
   await client.mcpInstance.deleteMany();
+  await client.promptRequest.deleteMany();
+  await client.prompt.deleteMany();
   await client.projectServer.deleteMany();
-  await client.projectMember.deleteMany();
   await client.secret.deleteMany();
   await client.session.deleteMany();
   await client.project.deleteMany();

src/db/tests/models.test.ts

@@ -1,6 +1,12 @@
 import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
 import type { PrismaClient } from '@prisma/client';
 import { setupTestDb, cleanupTestDb, clearAllTables, getTestClient } from './helpers.js';
+import { seedTemplates } from '../src/seed/index.js';
+import type { SeedTemplate } from '../src/seed/index.js';
+
+// Wrap all tests in a single describe to scope lifecycle hooks
+// and prevent leakage when running in the same worker as other test files.
+describe('db models', () => {
 
 let prisma: PrismaClient;
 
@@ -496,45 +502,6 @@ describe('ProjectServer', () => {
   });
 });
 
-// ── ProjectMember model ──
-
-describe('ProjectMember', () => {
-  it('links project to user with role', async () => {
-    const user = await createUser();
-    const project = await createProject({ ownerId: user.id });
-    const pm = await prisma.projectMember.create({
-      data: { projectId: project.id, userId: user.id, role: 'admin' },
-    });
-    expect(pm.role).toBe('admin');
-  });
-
-  it('defaults role to member', async () => {
-    const user = await createUser();
-    const project = await createProject({ ownerId: user.id });
-    const pm = await prisma.projectMember.create({
-      data: { projectId: project.id, userId: user.id },
-    });
-    expect(pm.role).toBe('member');
-  });
-
-  it('enforces unique project-user pair', async () => {
-    const user = await createUser();
-    const project = await createProject({ ownerId: user.id });
-    await prisma.projectMember.create({ data: { projectId: project.id, userId: user.id } });
-    await expect(
-      prisma.projectMember.create({ data: { projectId: project.id, userId: user.id } }),
-    ).rejects.toThrow();
-  });
-
-  it('cascades delete when project is deleted', async () => {
-    const user = await createUser();
-    const project = await createProject({ ownerId: user.id });
-    await prisma.projectMember.create({ data: { projectId: project.id, userId: user.id } });
-    await prisma.project.delete({ where: { id: project.id } });
-    const members = await prisma.projectMember.findMany({ where: { projectId: project.id } });
-    expect(members).toHaveLength(0);
-  });
-});
 
 // ── Project new fields ──
 
@@ -566,3 +533,74 @@ describe('Project new fields', () => {
     expect(project.llmModel).toBeNull();
   });
 });
+
+// ── seedTemplates ──
+
+const testTemplates: SeedTemplate[] = [
+  {
+    name: 'github',
+    version: '1.0.0',
+    description: 'GitHub MCP server',
+    packageName: '@anthropic/github-mcp',
+    transport: 'STDIO',
+    env: [{ name: 'GITHUB_TOKEN', description: 'Personal access token', required: true }],
+  },
+  {
+    name: 'slack',
+    version: '1.0.0',
+    description: 'Slack MCP server',
+    packageName: '@anthropic/slack-mcp',
+    transport: 'STDIO',
+    env: [],
+  },
+];
+
+describe('seedTemplates', () => {
+  it('seeds templates', async () => {
+    const count = await seedTemplates(prisma, testTemplates);
+    expect(count).toBe(2);
+
+    const templates = await prisma.mcpTemplate.findMany({ orderBy: { name: 'asc' } });
+    expect(templates).toHaveLength(2);
+    expect(templates.map((t) => t.name)).toEqual(['github', 'slack']);
+  });
+
+  it('is idempotent (upsert)', async () => {
+    await seedTemplates(prisma, testTemplates);
+    const count = await seedTemplates(prisma, testTemplates);
+    expect(count).toBe(2);
+
+    const templates = await prisma.mcpTemplate.findMany();
+    expect(templates).toHaveLength(2);
+  });
+
+  it('seeds env correctly', async () => {
+    await seedTemplates(prisma, testTemplates);
+    const github = await prisma.mcpTemplate.findUnique({ where: { name: 'github' } });
+    const env = github!.env as Array<{ name: string; description?: string; required?: boolean }>;
+    expect(env).toHaveLength(1);
+    expect(env[0].name).toBe('GITHUB_TOKEN');
+    expect(env[0].required).toBe(true);
+  });
+
+  it('accepts custom template list', async () => {
+    const custom: SeedTemplate[] = [
+      {
+        name: 'custom-template',
+        version: '2.0.0',
+        description: 'Custom test template',
+        packageName: '@test/custom',
+        transport: 'STDIO',
+        env: [],
+      },
+    ];
+    const count = await seedTemplates(prisma, custom);
+    expect(count).toBe(1);
+
+    const templates = await prisma.mcpTemplate.findMany();
+    expect(templates).toHaveLength(1);
+    expect(templates[0].name).toBe('custom-template');
+  });
+});
+
+}); // close 'db models' wrapper

src/db/tests/seed.test.ts

@@ -1,86 +0,0 @@
-import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
-import type { PrismaClient } from '@prisma/client';
-import { setupTestDb, cleanupTestDb, clearAllTables } from './helpers.js';
-import { seedTemplates } from '../src/seed/index.js';
-import type { SeedTemplate } from '../src/seed/index.js';
-
-let prisma: PrismaClient;
-
-beforeAll(async () => {
-  prisma = await setupTestDb();
-}, 30_000);
-
-afterAll(async () => {
-  await cleanupTestDb();
-});
-
-beforeEach(async () => {
-  await clearAllTables(prisma);
-});
-
-const testTemplates: SeedTemplate[] = [
-  {
-    name: 'github',
-    version: '1.0.0',
-    description: 'GitHub MCP server',
-    packageName: '@anthropic/github-mcp',
-    transport: 'STDIO',
-    env: [{ name: 'GITHUB_TOKEN', description: 'Personal access token', required: true }],
-  },
-  {
-    name: 'slack',
-    version: '1.0.0',
-    description: 'Slack MCP server',
-    packageName: '@anthropic/slack-mcp',
-    transport: 'STDIO',
-    env: [],
-  },
-];
-
-describe('seedTemplates', () => {
-  it('seeds templates', async () => {
-    const count = await seedTemplates(prisma, testTemplates);
-    expect(count).toBe(2);
-
-    const templates = await prisma.mcpTemplate.findMany({ orderBy: { name: 'asc' } });
-    expect(templates).toHaveLength(2);
-    expect(templates.map((t) => t.name)).toEqual(['github', 'slack']);
-  });
-
-  it('is idempotent (upsert)', async () => {
-    await seedTemplates(prisma, testTemplates);
-    const count = await seedTemplates(prisma, testTemplates);
-    expect(count).toBe(2);
-
-    const templates = await prisma.mcpTemplate.findMany();
-    expect(templates).toHaveLength(2);
-  });
-
-  it('seeds env correctly', async () => {
-    await seedTemplates(prisma, testTemplates);
-    const github = await prisma.mcpTemplate.findUnique({ where: { name: 'github' } });
-    const env = github!.env as Array<{ name: string; description?: string; required?: boolean }>;
-    expect(env).toHaveLength(1);
-    expect(env[0].name).toBe('GITHUB_TOKEN');
-    expect(env[0].required).toBe(true);
-  });
-
-  it('accepts custom template list', async () => {
-    const custom: SeedTemplate[] = [
-      {
-        name: 'custom-template',
-        version: '2.0.0',
-        description: 'Custom test template',
-        packageName: '@test/custom',
-        transport: 'STDIO',
-        env: [],
-      },
-    ];
-    const count = await seedTemplates(prisma, custom);
-    expect(count).toBe(1);
-
-    const templates = await prisma.mcpTemplate.findMany();
-    expect(templates).toHaveLength(1);
-    expect(templates[0].name).toBe('custom-template');
-  });
-});