base_mcp/
├── .agents/
│   └── skills/
│       └── base-mcp-starter/
│           └── SKILL.md            # AI Agent skill documentation
├── bin/
│   ├── cli.ts                      # Interactive Developer CLI
│   ├── mcp-server.ts               # Direct TS runner
│   └── mcp-server.js               # Autonomous zero-config Node runner
├── src/
│   ├── index.ts                    # Main library exports
│   ├── server.ts                   # Core BaseMCPServer JSON-RPC router
│   ├── config/
│   │   └── index.ts                # Server configuration & environment
│   ├── core/
│   │   ├── types.ts                # Protocol types
│   │   ├── logger.ts               # Stderr / file logger
│   │   ├── errors.ts               # JSON-RPC error codes & classes
│   │   └── transport.ts            # Stdio transport engine
│   ├── tools/
│   │   ├── base-tool.ts            # Abstract base tool with Zod parsing
│   │   ├── registry.ts             # Central tool registry
│   │   ├── index.ts                # Tool registry loader & registrations
│   │   └── examples/
│   │       ├── echo.tool.ts        # Echo sample tool
│   │       ├── system-info.tool.ts # System diagnostics sample tool
│   │       └── custom-template.tool.ts # Copy-paste blueprint
│   ├── resources/
│   │   ├── index.ts                # Resource manager
│   │   └── examples/
│   │       └── sample-resource.ts  # Sample dynamic resource
│   └── prompts/
│       ├── index.ts                # Prompt manager
│       └── examples/
│           └── sample-prompt.ts    # Sample prompt template
├── scripts/
│   ├── create-tool.ts              # Tool scaffolding generator
│   ├── test-stdio.ts               # End-to-end stdio protocol tester
│   └── export-schemas.ts           # Schema exporter to JSON files
├── templates/
│   └── mcp_config.example.json     # Client configuration snippets
├── tests/
│   ├── server.test.ts              # Server protocol tests
│   └── tools.test.ts               # Tool execution tests
├── package.json
├── tsconfig.json
├── vite.config.ts
├── vitest.config.ts
├── Build.bat
├── Run-Tests.bat
├── Start-Server.bat
└── Install-Dependencies.bat

npm install
# or double click Install-Dependencies.bat

npm run build
# or double click Build.bat

npm run test:all
# or double click Run-Tests.bat

# List all registered tools:
npm run cli list

# Call a tool directly:
npm run cli call echo '{"message": "Hello World!", "repeat": 2}'

npm run new-tool calculate_tax

import { z } from 'zod';
import { BaseTool } from './base-tool';
import { MCPToolCallResult } from '../core/types';

export const CalculateTaxSchema = z.object({
  amount: z.number().positive().describe('Total amount in USD'),
  taxRate: z.number().min(0).max(1).default(0.09).describe('Tax rate decimal (e.g. 0.09 for 9%)'),
});

export type CalculateTaxInput = z.infer<typeof CalculateTaxSchema>;

export class CalculateTaxTool extends BaseTool<typeof CalculateTaxSchema> {
  public readonly name = 'calculate_tax';
  public readonly description = 'Calculates total tax and grand total for a given amount.';
  public readonly schema = CalculateTaxSchema;

  public async execute(args: CalculateTaxInput): Promise<MCPToolCallResult> {
    const tax = args.amount * args.taxRate;
    const total = args.amount + tax;

    return this.jsonResult({
      originalAmount: args.amount,
      taxRate: args.taxRate,
      taxAmount: Math.round(tax * 100) / 100,
      grandTotal: Math.round(total * 100) / 100,
    });
  }
}

import { CalculateTaxTool } from './calculate-tax.tool';

export function createDefaultToolRegistry(): ToolRegistry {
  const registry = new ToolRegistry();
  
  // Register your new tool:
  registry.register(new CalculateTaxTool());

  return registry;
}

npm run cli call calculate_tax '{"amount": 100, "taxRate": 0.15}'

{
  "mcpServers": {
    "my-mcp": {
      "command": "node",
      "args": ["C:/Users/ASUS/Desktop/flutter_project/base_mcp/bin/mcp-server.js"]
    }
  }
}

{
  "mcpServers": {
    "my-mcp": {
      "command": "node",
      "args": ["C:/Users/ASUS/Desktop/flutter_project/base_mcp/bin/mcp-server.js"],
      "env": {
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

{
  "mcpServers": {
    "my-mcp": {
      "command": "node",
      "args": ["C:/Users/ASUS/Desktop/flutter_project/base_mcp/bin/mcp-server.js"]
    }
  }
}