API Creator

"# 🚀 API Creator MCP

NPM Version CI License Node Version

API Creator MCP is a specialized MCP (Model Context Protocol) server that generates complete, production-ready APIs. It supports REST, GraphQL, and microservices architectures with built-in security, validation, and deployment configurations.

✨ Features

• REST API Generation - Express/Fastify with database integration
• OpenAPI Conversion - Transform OpenAPI specs into working servers
• GraphQL API Generation - Apollo Server with subscriptions support
• Microservice Generation - gRPC, Kafka, RabbitMQ with service discovery
• Deployment Configuration - Docker, Kubernetes, AWS Lambda, Vercel
• Security First - JWT auth, Zod validation, rate limiting, path sanitization
• TypeScript Native - Full type safety with strict TypeScript
• Observability - OpenTelemetry tracing and Prometheus metrics

📋 Prerequisites

• Node.js 20+
• npm 9+

🚀 Installation

Via npx (recommended)

npx api-creator-mcp

Via npm global install

npm install -g api-creator-mcp
api-creator-mcp

Via GitHub

git clone https://github.com/yourusername/api-creator-mcp.git
cd api-creator-mcp
npm install
npm run build
npm link
api-creator-mcp

🔧 Configuration for Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "api-creator-mcp": {
      "command": "npx",
      "args": ["-y", "api-creator-mcp"]
    }
  }
}

🔧 Configuration for Cursor

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "api-creator-mcp": {
      "command": "npx",
      "args": ["-y", "api-creator-mcp"]
    }
  }
}

🛠️ Available Tools

1. create_rest_api

Generate a complete REST API with Express/Fastify.

{
  "name": "tasks-api",
  "endpoints": [
    { "path": "/tasks", "method": "GET", "description": "List all tasks" },
    { "path": "/tasks", "method": "POST", "description": "Create a task" },
    { "path": "/tasks/:id", "method": "DELETE", "description": "Delete a task" }
  ],
  "database": "postgres",
  "authentication": true,
  "validation": true
}

2. generate_from_openapi

Convert an OpenAPI specification into a working server.

{
  "openapi_spec": "{\"openapi\":\"3.0.0\",...}",
  "output_language": "typescript",
  "generate_sdk": true
}

3. create_graphql_api

Generate a GraphQL API with Apollo Server.

{
  "name": "blog-api",
  "schema": {
    "types": "type Post { id: ID! title: String! content: String! }",
    "queries": "posts: [Post]",
    "mutations": "createPost(title: String!, content: String!): Post"
  },
  "data_source": "postgres",
  "subscriptions": true
}

4. create_microservice

Generate a microservice with async communication.

{
  "name": "order-service",
  "communication": "kafka",
  "service_discovery": "consul",
  "observability": true
}

5. deploy_api

Deploy a generated API to cloud platforms.

{
  "api_path": "./generated-apis/tasks-api",
  "platform": "docker",
  "environment": {
    "NODE_ENV": "production",
    "PORT": "3000"
  }
}

📖 Usage Examples

Creating a Task Management API

# The MCP server will generate:
# - Express server with TypeScript
# - PostgreSQL integration with Prisma
# - JWT authentication
# - Zod validation for all endpoints
# - Complete project structure

Converting an Existing API

# Provide your OpenAPI 3.0 spec
# The server will generate:
# - Fully typed TypeScript server
# - Client SDK for easy integration
# - All endpoints from your spec

🔒 Security

• Input Validation: All parameters validated with Zod schemas
• Rate Limiting: 100 requests per minute per client
• Path Sanitization: Prevents path traversal attacks
• Permission System: Role-based access control
• No eval/exec: Safe template literals only
• JWT Authentication: Built-in auth middleware

📁 Project Structure

api-creator-mcp/
├── src/
│   ├── core/           # MCP server core
│   ├── tools/          # Tool implementations
│   ├── types/          # TypeScript types and Zod schemas
│   └── utils/          # Security and validation utilities
├── tests/
│   ├── unit/           # Unit tests
│   └── integration/    # Integration tests
├── templates/          # API templates
└── docs/               # Documentation

🧪 Testing

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Watch mode
npm run test:watch

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol
• Express.js
• Apollo GraphQL
• gRPC

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions"