🍃 Furikake (o furi)

Furikake es una CLI y API local fácil de usar para la gestión y ejecución de MCP.

• Descargar servidores MCP [desde GitHub]

• Detección de Smithery.yaml (o detección/manejo automático de la ejecución)

• CLI con todas las funciones [nanospinners, legibilidad]

• Se admiten los MCP integrados de Typescript y Javascript

• Los MCP basados en Python son un elemento clave de la hoja de ruta (y recibirán soporte)

• Rutas de API HTTP (utiliza Bun http, stdio a http, rutas claras y estándar)

• Puerto personalizable y visibilidad de las rutas sudo

• Ver todos los MCP en ejecución + registros para cada proceso

• Gestión del estado del proceso con PM2

• Creado con Bun y Typescript

• es bueno con arroz

Instalación (macOS/Linux)

Para instalar Furikake, puedes usar el siguiente comando:

curl -fsSL https://furikake.app/install | bash

Verifique la instalación ejecutando:

furi

Furikake usa Bun bajo el capó, el script de instalación instalará Bun si aún no está instalado.

Actualizar Furikake

Para actualizar Furikake a la última versión, ejecute:

furi upgrade

Related MCP server: DevServer MCP

Cómo utilizar

Administrar MCP

Furikake funciona con cualquier repositorio público de Github de la siguiente manera:

furi add <author/repo>

p. ej. furi agrega smithery-ai/mcp-fetch

También puede cambiar el nombre de un MCP utilizando el comando rename ; tenga en cuenta que esto reiniciará el MCP si se está ejecutando.

furi rename <old-name> <new-name>

p. ej. furi renombra smithery-ai/mcp-fetch mcp-fetch

Eliminar un MCP

furi remove <mcpName>

p. ej. furi elimina mcp-fetch

Lista de MCP instalados

Mostrar todos los MCP instalados

furi list

Iniciar un MCP

furi start <mcpName> -e '{"name1":"value1", "name2":"value2"}'

-e env es opcional y depende del servidor MCP al que se llama

Asegúrese de pasar un objeto JSON válido al indicador -e .

Una vez que inicie un servidor con el indicador -e , se guardará en el archivo de configuración y se reutilizará cuando vuelva a utilizar el servidor.

Para ver las variables de entorno necesarias para un MCP, utilice:

furi env <mcpName>

Puede obtener una lista de todas las herramientas disponibles (con detalles) de cualquier MCP utilizando:

furi tools <mcpName>

Luego puedes llamar a la herramienta con:

Llamar a una herramienta

furi call <mcpName> <toolName> '{"param1":"value1", "param2":"value2"}'

Los parámetros deben ser una cadena JSON válida entre comillas simples

Detener un MCP

furi stop <mcpName>

Reiniciar un MCP

furi restart <mcpName>

Obtener el estado de todos los MCP en ejecución

Esto le mostrará el estado de todos los MCP en ejecución.

furi status

Si desea obtener los registros de un MCP específico, puede utilizar:

furi status <mcpName>

Para ver más líneas de salida, use -l <lines>

Almacenamiento de configuración

Todos los MCP instalados, su configuración y registros se almacenan en el directorio .furikake , que se puede encontrar ejecutando:

furi where

Uso del agregador MCP

Puede utilizar Furikake con cualquier cliente MCP como Cursor a través del Agregador MCP.

Furi recopila herramientas de todos los MCP en ejecución y las expone a través de un endpoint SSE al que tu aplicación o cliente de MCP puede suscribirse. El agregador crea automáticamente la lista de herramientas de todos los MCP en ejecución y detecta nuevas herramientas a medida que los MCP se inician y se detienen.

Para iniciar el servidor agregador:

furi meta start

Esto también le mostrará el punto final al que su cliente MCP debe suscribirse.

Puede especificar un puerto personalizado:

furi meta start -p 9338

Si no pasa un puerto, el valor predeterminado será 9338

Para detener el agregador:

furi meta stop

Para reiniciar el agregador (conservando la configuración del puerto):

furi meta restart

Para comprobar el estado del servidor agregador:

furi meta status

Para ver más líneas de salida, use -l <lines>

Uso de la API HTTP

• Cualquier MCP que se esté ejecutando tendrá automáticamente una ruta http.

• Solo se puede activar o desactivar un MCP mediante la CLI.

Para acceder a su MCP a través de http, puede activar el proxy a través de:

furi http start

Para pasar un puerto, puedes utilizar el indicador http start -p <port> .

furi http start -p 9339

Si no pasa un puerto, el valor predeterminado será 9339

Para desactivar la ruta, puedes utilizar:

furi http stop

Referencia de API HTTP

La API HTTP de Furikake se divide en rutas públicas y rutas sudo . Las rutas públicas son accesibles por defecto, mientras que las rutas sudo deben habilitarse explícitamente. Con las rutas sudo, puede administrar activamente paquetes e instancias a través de la API HTTP.

Formato de respuesta de la API

Todos los puntos finales de API siguen un formato de respuesta JSON estandarizado:

• Respuestas de éxito :

  {
    "success": true,
    "data": {"The response varies by endpoint"}
  }

• Respuestas de error :

  {
    "success": false,
    "message": "Descriptive error message"
  }

Métodos HTTP

• POST : se utiliza solo para los puntos finales /mcpName/call/toolName y /mcpName/start

• GET - Se utiliza para todos los demás puntos finales

Rutas públicas

Ejemplo de uso:

Lista de MCP en ejecución:

curl http://localhost:9339/list

Para ver todas las herramientas disponibles para todos los MCP en línea, puede utilizar:

curl "http://localhost:9339/list"

Lista de herramientas para todos los MCP en línea:

curl http://localhost:9339/tools

Enumere las herramientas para un MCP específico:

curl http://localhost:9339/<mcpName>/tools

Llamar a una herramienta:

curl -X POST http://localhost:9339/<mcpName>/call/<toolName> -d '{"data1":"value1", "data2":"value2"}'

Rutas de Sudo

Para habilitar rutas sudo que permitan la administración de API de MCP:

furi http start --sudo

Ejemplo de uso:

Obtener el estado de todos los MCP:

curl http://localhost:9339/status

Instalar un MCP:

curl http://localhost:9339/add/<author>/<repo>

Obtener el estado y los registros de un MCP específico:

curl "http://localhost:9339/<mcpName>/status?lines=20"

Iniciar un MCP con variables de entorno:

curl -X POST http://localhost:9339/<mcpName>/start -d '{"API_KEY":"your-api-key-here"}'

Reiniciar un MCP:

curl http://localhost:9339/<mcpName>/restart

Detener un MCP:

curl http://localhost:9339/<mcpName>/stop

Cambiar el nombre de un MCP:

curl "http://localhost:9339/<mcpName>/rename?newName=<newName>"

Quitar un MCP:

curl http://localhost:9339/<mcpName>/remove

Si enfrenta algún problema con el servidor API HTTP, puede usar el furi http status para depurarlo.

Notas de cierre

Si has llegado hasta aquí, espero que Furikake te resulte útil y te ahorre tiempo. Lo creé por diversión para poder trabajar con MCP de forma más práctica. Si quieres contribuir, no dudes en abrir una incidencia o una solicitud de incorporación de cambios. Lo fusionaré después de revisar tus cambios.

Si crees que es una buena idea, marca el repositorio con una estrella.

Gracias por visitar Furikake.