Herramienta gratuita

De OpenAPI a servidor MCP en Rust

Ya tienes una especificación OpenAPI. Así se convierte en un servidor MCP que funciona en Rust, y estas son las partes que un conversor no puede hacer por ti.

SDK oficial modelcontextprotocol/rust-sdk (rmcp)
Instalación
cargo add rmcp
Una herramienta MCP que funciona en Rust 
#[derive(Debug, Deserialize, JsonSchema)]
struct GetOrderArgs {
    /// The order id to look up
    order_id: String,
}

#[tool_router]
impl MyServer {
    #[tool(description = "Look up one order by its id and return its current status.")]
    async fn get_order(&self, Parameters(args): Parameters<GetOrderArgs>)
        -> Result<CallToolResult, McpError> {
        Ok(CallToolResult::success(vec![Content::text(fetch_order(&args.order_id).await)]))
    }
}
Prueba lo que has creado Genera herramientas desde una spec OpenAPI

Generado, en marcha y todavía invisible.

Convertir una especificación te da un servidor. No te da a nadie que quiera usarlo. MCP Showcase convierte el mismo endpoint en un playground en vivo con documentación legible para cada herramienta.

Comienza gratis Explora el directorio de servidores MCP

Cómo funciona

link
Convierte la especificación

El conversor de OpenAPI convierte cada operación en una definición de herramienta MCP, en tu navegador y sin subir tu especificación.

play_circle
Cablealo en Rust

Toma las definiciones de herramientas generadas e impleméntalas contra tu API con el SDK de Rust, con la forma que se muestra arriba.

checklist
Recorta la lista

Una especificación convertida te da una herramienta por operación, y eso casi siempre son demasiadas. Quédate con las que un agente necesita.

De la especificación a Rust

La mitad mecánica lo es de verdad: cada operación OpenAPI pasa a ser una herramienta MCP, su summary pasa a ser la descripción y sus parámetros de ruta, consulta y cuerpo se aplanan en un único esquema de entrada. El conversor de OpenAPI hace esa parte en tu navegador, sin subir tu especificación.

Lo que queda tiene forma de Rust: implementar esas herramientas contra tu API con modelcontextprotocol/rust-sdk (rmcp) (cargo add rmcp), con la forma que se muestra arriba.

El runtime asíncrono y la derivación de esquemas son ambos explícitos

rmcp se apoya en Tokio y deriva los esquemas con schemars, así que tanto el runtime como la derivación de esquemas son decisiones que tomas y no valores por defecto que heredas. Cuenta con más preparación que en Python para el mismo servidor, y con que el compilador atrape los errores de esquema que otros SDK descubren en ejecución.

Lo que ningún conversor puede hacer por ti

  • La autenticación. El código generado llama a tu API sin credenciales. Cablear la cabecera, el token o el flujo OAuth es cosa tuya.
  • Reescribir las descripciones. Una summary de OpenAPI está escrita para una persona que lee documentación. Una descripción de herramienta MCP la lee un modelo que decide qué llamar. Son trabajos distintos, y las summaries suelen necesitar reescritura una vez convertidas.
  • Elegir qué exponer. Un conversor te dará una herramienta por operación. Para la mayoría de APIs eso es un orden de magnitud de más.
  • Resolver cuerpos con $ref. Resolverlos necesita tu sección components, así que llegan como objeto genérico.

Por qué importa tanto el número de herramientas

Las definiciones de herramientas se envían al modelo en cada petición, no una vez por sesión. Ochenta operaciones son ochenta descripciones y ochenta esquemas en la ventana de contexto de cada turno, pagados de forma continua y medibles peor al elegir que una lista corta. La calculadora de tokens muestra lo que cuesta una lista dada; el linter de esquemas muestra si las descripciones sobrevivieron a la conversión en un estado utilizable.

Herramientas y guías relacionadas

Generado no es lo mismo que utilizable

Un servidor convertido demuestra que la correspondencia funcionó. A un cliente potencial no le dice nada: no sabe leer Rust y no configurará un cliente para averiguarlo. MCP Showcase convierte el mismo endpoint en un playground en vivo con documentación por herramienta que cualquiera puede probar en un navegador.

Preguntas frecuentes

La correspondencia es mecánica: cada operación pasa a ser una herramienta, su summary pasa a ser la descripción y sus parámetros se aplanan en un único esquema de entrada. Lo que no es mecánico: la autenticación, el manejo de errores y decidir qué operaciones merecen estar en la lista de herramientas.

La autenticación, que añades tú. Los cuerpos de petición tras un $ref, cuya resolución necesita tu sección components. Y el criterio: un conversor te dará encantado ochenta herramientas, que es peor que ocho.

Porque las definiciones de herramientas se envían al modelo en cada petición. Ochenta operaciones son ochenta descripciones y ochenta esquemas en el contexto de cada turno, pagados de forma continua, y a la vez hacen al modelo medible peor eligiendo entre ellas.

Sí, y conviene saberlo antes de convertir. Una summary de OpenAPI está escrita para una persona que lee documentación; una descripción de herramienta MCP la lee un modelo que decide qué llamar. Son dos trabajos distintos, y las summaries suelen necesitar reescritura después.

Despliégalo y pasa la URL por el MCP Inspector para confirmar el handshake y la lista de herramientas, y luego por el linter de esquemas para ver si las descripciones han sobrevivido lo bastante bien como para que un modelo elija correctamente.

Más herramientas MCP gratuitas

MCP Inspector online

Pega la URL de un servidor MCP y mira todas las herramientas, recursos y prompts que expone, con esquemas completos y el registro de peticiones. Nada que instalar.
Probador de servidores MCP

Comprueba que tu servidor MCP funciona de verdad. Pega la URL y obtén un informe de aprobado/fallo sobre la conexión, el handshake, el transporte y las herramientas que anuncia.
Escáner de seguridad MCP

Antes de apuntar un agente a un servidor MCP, mira qué está pidiendo. Calificado de la A a la F en transporte, autenticación, indicios de tool poisoning y parámetros peligrosos.
Calculadora de tokens MCP

Las definiciones de herramientas se envían en cada petición, no una sola vez. Pega la URL de tu servidor MCP y descubre cuántos tokens son, cuáles pesan más y cuánto cuesta.
Ver todas las herramientas gratuitas