curl mcp : el último MCP que necesitarás

[!IMPORTANTE] TRABAJO EN PROGRESO

Requisitos:

Expone una API REST simple (con OpenAPI) así como MCP remoto
Fácil de usar a través de cualquier cliente MCP, a través de API y a través de navegadores.
X y GitHub OAuth
Depósito de crédito de Stripe
Instrucciones contextuales
Proxy de transformación Markdown para sitios web populares como X y GitHub
Uso gratuito limitado (límite de tarifa por hora), pague por uso después de alcanzar el límite.
Plantillas de instrucciones para compartir

Mis principios para hacer que el LLM realmente funcione bien con toneladas de herramientas:

Como el LLM conoce sitios web populares, instrúyalo para que simplemente use la web como siempre.
Bajo el agua, asegúrese de que cada entrada se dirija de alguna manera al sitio web sustituto correcto.
Asegúrese de que cada respuesta sea en formato Markdown y contenga muy pocos tokens, idealmente menos de 1000. Esto nos permite realizar muchos pasos.
Asegúrese de que los callejones sin salida guíen al LLM nuevamente hacia el buen camino.
Asegúrese de que cada paso de un proceso de varios pasos contenga instrucciones sobre qué hacer a continuación.
Asegúrese de que la ruta que visita el LLM coincida con la que visita el usuario o el rastreador. Responda correctamente al encabezado de aceptación y a otra información para distinguirlos.

¿Cómo deberían prepararse los fabricantes de productos de hoy para permitir esto?

La mayoría de las API usan POST, pero es más fácil aprender sobre GET, ya que se puede usar en Markdown. Promovamos el uso de API GET y estructuras de URL fáciles de entender con una longitud de token mínima.
Asegúrate de usar OpenAPI para mostrar los posibles puntos finales y el enrutamiento. Tu API debe ser el ciudadano de primera clase, no tu sitio web.
Asegúrese de hacer que su openapi sea explorable colocándolo directamente en la raíz en /openapi.json o redirigiéndolo desde /.well-known/openapi si eso no es posible.
Asegúrese de que todas sus páginas que están expuestas como texto/html también expongan una variante que no sea HTML (preferiblemente Markdown o yaml si los datos estructurados también pueden ser útiles) que tenga menos de 1000 tokens con la misma funcionalidad o una similar.
Detectar errores en tu API siempre debería guiar al agente de vuelta al camino correcto, al igual que lo hacemos con los humanos. ¡Intenta desarrollar estas vías de UX a nivel de API!

¿Es posible, de alguna manera, proporcionar esto como middleware a las API? ¡Por supuesto! La única herramienta para controlarlas todas es curl (o fetch), y podría hacerse de forma segura de la siguiente manera:

Asegúrese de alejarse de los sitios web centrados en los humanos y dirigirse a sitios web optimizados con inteligencia artificial.
Asegúrese de truncar la respuesta para que nunca supere un cierto límite
Asegúrese de preferir aceptar rebajas

Uso

Uso de MCP:

Instálelo en su cliente MCP agregando lo siguiente a su configuración:

{
  "mcpServers": {
    "curlmcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://curlmcp.com/sse"]
    }
  }
}

Uso del navegador

La API de curlmcp también es fácil de usar desde el navegador. La autenticación se gestiona automáticamente.

Uso de la CLI

Puedes simplemente usar curl tú mismo o tener el proxy curl mcp:

Utilice curl -c cookies.txt https://curlmcp.com/login para iniciar sesión y almacenar cookies
use curl -b cookies.txt https://curlmcp.com/curl/{your-request}

Uso de API: `/curl/{url}`

El punto final /curl/{url} permite enviar solicitudes HTTP a cualquier URL, imitando el comportamiento de la herramienta de línea de comandos curl . Admite parámetros de consulta largos para especificar detalles de la solicitud, como el método HTTP, los encabezados y los datos.

Algunas URL están configuradas para ser redirigidas según su plantilla configurada (el valor predeterminado es default-proxy.yaml )

Especificación API

GET /curl/{url}?request={method}&header={header}&data={data}&...

NB: {url} utiliza el protocolo https de forma predeterminada.

Parámetros de consulta admitidos

Parámetro	Tipo	Descripción	Ejemplo
`request`	cadena	Especifica el método HTTP. Valores válidos: `GET` , `POST` , `PUT` , `DELETE` , `PATCH` , `HEAD` y `OPTIONS` .	`request=POST`
`header`	matriz de cadenas	Añade encabezados HTTP personalizados. Repita este proceso para varios encabezados.	`header=Content-Type:application/json`
`data`	matriz de cadenas	Envía datos en el cuerpo de la solicitud (POST) o en la cadena de consulta (con `get=true` ). Repita este proceso para varios pares de datos.	`data=key=value`
`data-urlencode`	matriz de cadenas	Envía datos codificados en URL en la solicitud.	`data-urlencode=comment=this is awesome`
`get`	booleano	Fuerza a que los datos se envíen como una cadena de consulta de solicitud GET.	`get=true`
`include`	booleano	Incluye encabezados de respuesta en la salida.	`include=true`
`head`	booleano	Envía una solicitud HEAD.	`head=true`
`user`	cadena	Especifica las credenciales para la autenticación (formato: `username:password` ).	`user=user:pass`
`location`	booleano	Sigue redirecciones HTTP.	`location=true`
`verbose`	booleano	Habilita la salida detallada para la depuración.	`verbose=true`
`access_token`	cadena	Inyecta un token OAuth para la autenticación X o GitHub.	`access_token=xyz`
`instructions`	cadena	Especifica instrucciones contextuales para la solicitud.	`instructions=transform_response_to_markdown`

Campo de golf

Intento anterior (API curl): https://github.com/janwilmake/curlapi
Intento anterior (obtener mcp): https://github.com/janwilmake/fetch-mcp

Integrations