Examples & Tutorials

Welcome to the gen-mcp examples gallery! These comprehensive tutorials demonstrate how to integrate different types of services and APIs as MCP tools. Each example includes step-by-step instructions, configuration breakdowns, and best practices.

Whether you’re wrapping a local CLI tool, converting a REST API, or integrating a gRPC service, these examples will guide you through the process.


πŸ€– Ollama Integration

Connect local language models to MCP Clients with gen-mcp in two ways: by wrapping the Ollama CLI, and by wrapping the Ollama HTTP endpoints.

What you'll learn:

  • HTTP-based and CLI-based tool integration
  • Input schema validation
  • Tool configuration best practices

πŸ”— HTTP API Conversion

Transform any REST API into MCP tools automatically. Learn how to use OpenAPI specs to generate complete MCP servers in seconds.

What you'll learn:

  • Automatic OpenAPI β†’ MCP conversion
  • Path parameter substitution
  • Customizing generated configurations

πŸ”Œ gRPC Service Integration

Expose existing gRPC services to LLMs without modifying service code using gRPC-Gateway to create an HTTP/JSON proxy.

Perfect for:

  • 🏒 Integrating legacy gRPC services with AI workflows
  • πŸ”„ Bridging binary gRPC with JSON-based LLM interfaces
  • πŸš€ Getting started before native gRPC support arrives

More Examples Coming Soon

We’re continuously adding new examples and tutorials. Have an interesting use case? Share it on our Discord community or contribute it on GitHub!