KEN-MCP TypeScript Edition

Universal MCP Server Generator - Now in pure TypeScript!

Overview

This is the TypeScript version of KEN-MCP, completely rewritten to eliminate Python dependencies. It generates MCP (Model Context Protocol) servers from natural language requirements using the official @modelcontextprotocol/sdk TypeScript package.

Why TypeScript?

The Python version had several pain points:

• Complex dependency issues (cffi, cryptography)
• Platform-specific compilation requirements
• Python runtime needed on user machines
• Difficult cross-platform deployment

The TypeScript version solves all these issues:

• ✅ Single npm install - no compilation needed
• ✅ Pure JavaScript output - runs anywhere Node.js runs
• ✅ Better type safety and IDE support
• ✅ Simpler NPX deployment
• ✅ No Python runtime required

Installation

npm install -g ken-kai-mcp

Or use directly with npx:

npx ken-kai-mcp

Usage

Add to Claude Code:

claude mcp add ken-mcp-ts -s user -- npx -y ken-kai-mcp

Features

• 🚀 Natural Language to MCP: Describe what you want, get a working MCP server
• 📦 Pure TypeScript: No Python dependencies or runtime needed
• 🔧 Complete Generation: Creates tools, resources, prompts, tests, and documentation
• 🎯 Smart Analysis: Intelligently parses requirements to create appropriate APIs
• 📝 Full Documentation: Generates README, CLAUDE.md, and inline documentation
• ✅ Test Suite: Includes Jest tests for all generated components

Example

Generate a todo list manager:

Requirements: "I want an MCP that manages todo lists with create, update, delete, and list operations"

This generates:

• Complete TypeScript MCP server
• CRUD operations for todos
• Resource endpoints
• Helper prompts
• Full test suite
• Documentation

Architecture

ken-mcp-ts/
├── src/
│   ├── core/          # Core logic (analyzer, parser, orchestrator)
│   ├── generators/    # Code generators for different components
│   ├── utils/         # Utility functions
│   └── index.ts       # Main MCP server entry
├── dist/              # Compiled JavaScript
└── bin/               # NPX executable

ES Module Configuration

This project uses ES modules (ESM) for better compatibility with the MCP SDK:

• TypeScript Config: Uses "module": "Node16" and "moduleResolution": "Node16"
• Package.json: Includes "type": "module"
• Imports: All imports use .js extensions as required by Node.js ES modules
• Generated Projects: All generated MCP servers also use ES modules

This ensures seamless integration with the @modelcontextprotocol/sdk which is designed for ES modules.

Migration from Python Version

If you're migrating from the Python version:

1. Generated servers are now TypeScript-based
2. Dependencies use npm instead of pip
3. No Python runtime needed for generated servers
4. Same natural language interface
5. Compatible with the same MCP protocol

Development

# Clone the repository
git clone <repo>
cd ken-mcp-ts

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

Benefits Over Python Version

| Feature | Python Version | TypeScript Version | |---------|---------------|-------------------| | Installation | Complex (cffi, cryptography) | Simple (npm install) | | Runtime | Python 3.10+ required | Node.js 16+ required | | Dependencies | pip + system libraries | npm only | | Type Safety | Runtime type checking | Compile-time + runtime | | IDE Support | Basic | Excellent | | Deployment | Python + dependencies | Single JS bundle | | Cross-platform | Platform-specific builds | Universal |

License

MIT

Built with ❤️ using TypeScript and the official MCP SDK