Home | gen-mcp

What is gen-mcp?

gen-mcp eliminates the complexity of building Model Context Protocol (MCP) servers. Instead of writing boilerplate code and learning protocol internals, simply describe your tools in a configuration file—gen-mcp handles the rest.

Perfect for:

🔌 API Developers

Expose existing REST APIs to AI assistants instantly without writing custom integration code.

🤖 AI Engineers

Connect LLMs to external tools without custom server code. Focus on AI, not infrastructure.

🛠️ DevOps Teams

Integrate legacy systems with modern AI workflows seamlessly and securely.

Key Features

🚀 Zero-Code Server Generation

Create MCP servers from simple YAML configs. No programming required.

📡 OpenAPI Auto-Conversion

Transform existing OpenAPI specs into MCP servers instantly with a single command.

🔄 Real-Time Tool Exposure

HTTP endpoints become callable AI tools automatically. No manual mapping needed.

🛡️ Built-in Validation

Schema validation and type safety out of the box. Catch errors before runtime.

🔐 Security Out of the Box

TLS encryption and OAuth/OIDC authentication built-in and ready to use.

⚡ Background Processing

Detached server mode with process management for production deployments.

Quick Start

1. Install GenMCP

Option A: Download Pre-built Binary

# Download from GitHub releases
# Visit: https://github.com/genmcp/gen-mcp/releases
# Or using curl (replace with latest version and platform):
curl -L https://github.com/genmcp/gen-mcp/releases/latest/download/genmcp-linux-amd64.zip -o genmcp-linux-amd64.zip
unzip genmcp-linux-amd64.zip
chmod +x genmcp-linux-amd64
sudo mv genmcp-linux-amd64 /usr/local/bin/genmcp

    

Verify the Signed Binary

You can cryptographically verify that the downloaded binaries are authentic using cosign:

# Install cosign (see https://docs.sigstore.dev/cosign/installation/)
# Download the bundle file from releases page, then verify:
cosign verify-blob-attestation \
  --bundle genmcp-linux-amd64.zip.bundle \
  --certificate-identity-regexp "https://github.com/genmcp/gen-mcp/.*" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  --new-bundle-format \
  genmcp-linux-amd64.zip

    

Option B: Build from Source

# Clone and build
git clone https://github.com/genmcp/gen-mcp.git
cd gen-mcp

# Build CLI
make build-cli

# Add to PATH (recommended)
sudo mv genmcp /usr/local/bin

    

2. Choose Your Adventure

Option A: Convert Existing API

genmcp convert https://api.example.com/openapi.json
genmcp run

Option B: Create Custom Tools

# Create mcpfile.yaml with your tools (see documentation)
genmcp run

3. See It In Action

📹 HTTP Conversion Demo 📹 Ollama Integration Demo

Note: These videos were recorded before the project was renamed from automcp to gen-mcp. The functionality remains the same.

Documentation

📖 MCP File Format

Learn to write custom tool configurations with our comprehensive guide.

Read Guide

📚 Examples

Real-world integration examples to get you started quickly.

View Examples

🔧 Core Commands

Master the essential gen-mcp CLI commands.

Learn Commands

Contributing

We welcome contributions! This is an early-stage research project with lots of room for improvement.

💬 Join Discord

Connect with other users, share ideas, and get help from the community.

Join Discord

🐛 Report Issues

Found a bug or have a feature request? Let us know on GitHub.

Report Issue

🛠️ Development Setup

Get started with local development in just a few commands.

View Setup Guide