feat: support mcp create . to scaffold in current directory

Allow users to run `mcp create .` to initialize a project in the
current working directory instead of creating a new subdirectory.
The project name is derived from the directory name, normalized to
a valid npm package name. Conflicting files (package.json, tsconfig.json,
src/) are detected and reported before scaffolding.

Closes #78

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: QuantGeekDev

src/cli/index.ts

@@ -47,7 +47,7 @@ program.command('build').description('Build the MCP project').action(buildFramew
 program
   .command('create')
   .description('Create a new MCP server project')
-  .argument('[name]', 'project name')
+  .argument('[name]', 'project name (use "." for current directory)')
   .option('--http', 'use HTTP transport instead of default stdio')
   .option('--cors', 'enable CORS with wildcard (*) access')
   .option('--port <number>', 'specify HTTP port (only valid with --http)', (val) =>

src/cli/project/create.ts

@@ -1,7 +1,7 @@
 import { createRequire } from 'module';
 import { spawnSync } from 'child_process';
-import { mkdir, writeFile } from 'fs/promises';
-import { join } from 'path';
+import { mkdir, readdir, writeFile } from 'fs/promises';
+import { basename, join } from 'path';
 import prompts from 'prompts';
 import { generateReadme } from '../templates/readme.js';
 import { execa } from 'execa';
@@ -49,17 +49,46 @@ export async function createProject(
     projectName = name;
   }
 
+  const isCurrentDir = name === '.';
+
+  if (isCurrentDir) {
+    // Derive project name from current directory name
+    projectName = basename(process.cwd())
+      .toLowerCase()
+      .replace(/[^a-z0-9-]/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .replace(/-{2,}/g, '-');
+
+    if (!projectName) {
+      console.error('❌ Error: Could not derive a valid project name from the current directory name');
+      console.error('   Please rename the directory or specify a project name: mcp create <name>');
+      process.exit(1);
+    }
+  }
+
   if (!projectName) {
     throw new Error('Project name is required');
   }
 
-  const projectDir = join(process.cwd(), projectName);
+  const projectDir = isCurrentDir ? process.cwd() : join(process.cwd(), projectName);
   const srcDir = join(projectDir, 'src');
   const toolsDir = join(srcDir, 'tools');
 
   try {
+    if (isCurrentDir) {
+      const entries = await readdir(projectDir);
+      const conflicts = ['package.json', 'tsconfig.json', 'src'].filter(f => entries.includes(f));
+      if (conflicts.length > 0) {
+        console.error(`❌ Error: Current directory already contains: ${conflicts.join(', ')}`);
+        console.error('   Please use an empty directory or specify a project name: mcp create <name>');
+        process.exit(1);
+      }
+    }
+
     console.log('Creating project structure...');
-    await mkdir(projectDir);
+    if (!isCurrentDir) {
+      await mkdir(projectDir);
+    }
     await mkdir(srcDir);
     await mkdir(toolsDir);
 
@@ -370,10 +399,12 @@ OAUTH_ISSUER=https://auth.example.com
 ✅ Project ${projectName} created and built successfully with OAuth 2.1!
 
 🔐 OAuth Setup Required:
-1. cd ${projectName}
+${isCurrentDir ? `1. Copy .env.example to .env
+2. Configure your OAuth provider settings in .env
+3. See docs/OAUTH.md for provider-specific setup guides` : `1. cd ${projectName}
 2. Copy .env.example to .env
 3. Configure your OAuth provider settings in .env
-4. See docs/OAUTH.md for provider-specific setup guides
+4. See docs/OAUTH.md for provider-specific setup guides`}
 
 📖 OAuth Resources:
    - Framework docs: https://github.com/QuantGeekDev/mcp-framework/blob/main/docs/OAUTH.md
@@ -385,11 +416,13 @@ OAUTH_ISSUER=https://auth.example.com
       } else {
         console.log(`
 Project ${projectName} created and built successfully!
-
+${isCurrentDir ? `
+Add more tools using:
+   mcp add tool <n>` : `
 You can now:
 1. cd ${projectName}
 2. Add more tools using:
-   mcp add tool <n>
+   mcp add tool <n>`}
     `);
       }
     } else {
@@ -398,26 +431,35 @@ You can now:
 ✅ Project ${projectName} created successfully with OAuth 2.1 (without dependencies)!
 
 Next steps:
-1. cd ${projectName}
+${isCurrentDir ? `1. Copy .env.example to .env
+2. Configure your OAuth provider settings in .env
+3. Run 'npm install' to install dependencies
+4. Run 'npm run build' to build the project
+5. See docs/OAUTH.md for OAuth setup guides` : `1. cd ${projectName}
 2. Copy .env.example to .env
 3. Configure your OAuth provider settings in .env
 4. Run 'npm install' to install dependencies
 5. Run 'npm run build' to build the project
-6. See docs/OAUTH.md for OAuth setup guides
+6. See docs/OAUTH.md for OAuth setup guides`}
 
 🛠️  Add more tools:
    mcp add tool <tool-name>
     `);
       } else {
         console.log(`
 Project ${projectName} created successfully (without dependencies)!
-
+${isCurrentDir ? `
+Next steps:
+1. Run 'npm install' to install dependencies
+2. Run 'npm run build' to build the project
+3. Add more tools using:
+   mcp add tool <n>` : `
 You can now:
 1. cd ${projectName}
 2. Run 'npm install' to install dependencies
 3. Run 'npm run build' to build the project
 4. Add more tools using:
-   mcp add tool <n>
+   mcp add tool <n>`}
     `);
       }
     }

tests/cli/create-current-dir.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+import { mkdtempSync, rmSync, existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+
+// Import createProject directly for unit testing
+import { createProject } from '../../src/cli/project/create.js';
+
+describe('mcp create . (current directory)', () => {
+  let tempDir: string;
+  const originalCwd = process.cwd();
+  const originalExit = process.exit;
+
+  beforeEach(() => {
+    tempDir = mkdtempSync(join(tmpdir(), 'mcp-test-'));
+    process.chdir(tempDir);
+  });
+
+  afterEach(() => {
+    process.chdir(originalCwd);
+    process.exit = originalExit;
+    rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('should scaffold project in the current directory when name is "."', async () => {
+    // Create a specifically named subdirectory to control the derived name
+    const projectDir = join(tempDir, 'my-test-server');
+    const { mkdirSync } = await import('fs');
+    mkdirSync(projectDir);
+    process.chdir(projectDir);
+
+    await createProject('.', { install: false, example: true });
+
+    // Verify files were created in the current directory (not a subdirectory)
+    expect(existsSync(join(projectDir, 'package.json'))).toBe(true);
+    expect(existsSync(join(projectDir, 'tsconfig.json'))).toBe(true);
+    expect(existsSync(join(projectDir, 'src', 'index.ts'))).toBe(true);
+    expect(existsSync(join(projectDir, 'src', 'tools', 'ExampleTool.ts'))).toBe(true);
+    expect(existsSync(join(projectDir, '.gitignore'))).toBe(true);
+    expect(existsSync(join(projectDir, 'README.md'))).toBe(true);
+
+    // No subdirectory should have been created
+    expect(existsSync(join(projectDir, '.'))).toBe(true);
+
+    // Verify project name was derived from directory name
+    const pkg = JSON.parse(readFileSync(join(projectDir, 'package.json'), 'utf-8'));
+    expect(pkg.name).toBe('my-test-server');
+    expect(pkg.description).toBe('my-test-server MCP server');
+    expect(pkg.bin['my-test-server']).toBe('./dist/index.js');
+  });
+
+  it('should derive a valid npm name from directory with uppercase/special chars', async () => {
+    const projectDir = join(tempDir, 'My_Cool.Server');
+    const { mkdirSync } = await import('fs');
+    mkdirSync(projectDir);
+    process.chdir(projectDir);
+
+    await createProject('.', { install: false, example: false });
+
+    const pkg = JSON.parse(readFileSync(join(projectDir, 'package.json'), 'utf-8'));
+    // Uppercase → lowercase, underscores/dots → hyphens
+    expect(pkg.name).toBe('my-cool-server');
+  });
+
+  it('should reject when current directory has conflicting files', async () => {
+    const projectDir = join(tempDir, 'existing-project');
+    const { mkdirSync, writeFileSync } = await import('fs');
+    mkdirSync(projectDir);
+    writeFileSync(join(projectDir, 'package.json'), '{}');
+    process.chdir(projectDir);
+
+    let exitCode: number | undefined;
+    process.exit = ((code?: number) => {
+      exitCode = code;
+      throw new Error('process.exit called');
+    }) as never;
+
+    await expect(createProject('.', { install: false })).rejects.toThrow('process.exit called');
+    expect(exitCode).toBe(1);
+  });
+});