servidor glif-mcp

Servidor MCP para ejecutar flujos de trabajo de IA desde glif.app.

Este servidor proporciona herramientas para ejecutar glifs, administrar bots y acceder a metadatos de glifs a través del Protocolo de contexto de modelo (MCP).

Este servidor también permite personalizar todas las herramientas disponibles mediante metaherramientas para agregar y quitar herramientas, entre otras, incluyendo muchos agentes glif completos como conjunto de herramientas (y personalidad). Esto es altamente experimental.

Para obtener más información, consulte https://glif.app o únase a nuestro servidor Discord: https://discord.gg/glif

Características

• Ejecutar glifs con entradas
• Obtenga información detallada sobre glifs, ejecuciones y usuarios
• Acceda a metadatos de glif a través de recursos basados en URI

Configuración

Ejecución mediante npx (recomendado)

Si tiene nodejs instalado, puede ejecutar nuestro paquete @glifxyz/glif-mcp-server a través de npx:

1. Obtén tu token API desde https://glif.app/settings/api-tokens
2. Añade el servidor en el archivo de configuración de Claude Desktop. En macOS, este es: ~/Library/Application Support/Claude/claude_desktop_config.json
   { "mcpServers": { "glif": { "command": "npx", "args": ["-y", "@glifxyz/glif-mcp-server@latest"], "env": { "GLIF_API_TOKEN": "your-token-here" } } } }

Corriendo desde una caja local

Primero, revise este código e instale las dependencias.

Luego configure su cliente MCP (por ejemplo, Claude Desktop) para cargar este servidor desde el disco.

También puede especificar los ID de glifs (separados por comas) que se cargarán automáticamente al iniciar el servidor. Esto es útil para realizar pruebas o si desea compartir una configuración de glif predefinida con otra persona.

Ejecutar de forma remota con Smithery

Para instalar glif-mcp para Claude Desktop automáticamente a través de Smithery , que aloja y ejecuta el servidor MCP para usted:

Límites de uso

• Sujeto a los mismos límites que las cuentas de usuario
• Compra más créditos en https://glif.app/pricing

Recursos

• glif://{id} - Obtener metadatos de glif
• glifRun://{id} - Obtener detalles de la ejecución
• glifUser://{id} - Obtener el perfil del usuario

Herramientas

Herramientas generales de Glif

• run_glif - Ejecuta un glif con el ID y las entradas especificadas
• glif_info - Obtenga información detallada sobre un glif, incluidos los campos de entrada
• list_featured_glifs - Obtenga una lista seleccionada de glifs destacados
• search_glifs - Busca glifs por nombre o descripción

Herramientas de bot

• list_bots - Obtén una lista de bots destacados y plantillas de simulación
• load_bot - Obtén información detallada sobre un bot específico, incluidas sus habilidades
• save_bot_skills_as_tools : guarda todas las habilidades de un bot como herramientas individuales

Herramientas específicas del usuario

• my_glifs - Obtén una lista de tus glifs
• my_glif_user_info - Obtenga información detallada sobre su cuenta de usuario, glifs recientes y ejecuciones recientes

Glif->Herramientas Herramientas (metaherramientas)

• save_glif_as_tool - Guardar un glif como una herramienta personalizada
• remove_glif_tool - Eliminar una herramienta glif guardada
• remove_all_glif_tools : elimina todas las herramientas glif guardadas y regresa a un estado original
• list_saved_glif_tools - Lista todas las herramientas glif guardadas

Cómo convertir glifs en herramientas personalizadas

Tenemos una herramienta general run_glif , pero (a) no es muy descriptiva y (b) requiere primero una llamada glif_info para aprender a llamar a dicho glif. Además, es necesario saber que glif existe.

Estamos experimentando con varias metaherramientas nuevas que convierten glifs específicos en nuevas herramientas independientes:

Un ejemplo de sesión rápida:

• ¿Cuales son algunos nuevos y geniales gráficos?
• [toolcall: list_featured_glifs ...]
• Vale, me gusta el generador de portadas de libros de ciencia ficción de los años 70. Conviértelo en una herramienta llamada "scifi_book_image".
• [toolcall: save_glif_as_tool glifId=... toolName=scifi_book_image ]
• [Ahora el usuario puede simplemente escribir "crear una imagen de libro de ciencia ficción de bla bla"]

Puede enumerar estas herramientas especiales con list_saved_glif_tools y eliminar cualquiera que no le guste con remove_glif_tool

Tenga en cuenta que Claude Desktop requiere reiniciarse para cargar nuevas definiciones de herramientas. Cline y Cursor parecen recargarse automáticamente al realizar cambios y volver a consultar las herramientas disponibles.

Información sobre los glifs del usuario autenticado:

• my_glifs - glifs publicados por el usuario actual (sin drats)
• my_liked_glifs - glifs que le gustan al usuario actual
• my_runs - carreras públicas del usuario actual

Desarrollo

Instalar dependencias:

Construir el servidor:

Para desarrollo con reconstrucción automática:

Para ejecutar el conjunto de pruebas:

Y ejecutar continuamente pruebas sobre los cambios:

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP :

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

También puedes consultar los registros glif-mcp dentro de los registros de Claude directamente si estás usando Claude Desktop.

Registros MCP

Desarrollo

Lanzando una nueva versión

1. Edite package.json y src/index.ts y aumente el número de versión
2. Ejecute npm install para actualizar las versiones almacenadas en el archivo de bloqueo
3. Confirme y envíe sus cambios a GitHub y combínelos con el archivo principal
4. Si tienes gh instalado, cambia a la versión principal y ejecuta npm run release Esto creará una etiqueta de Git para la nueva versión, la subirá a GitHub y usará gh release create para publicar una nueva versión con un registro de cambios generado automáticamente. Si no tienes gh , puedes hacer lo anterior manualmente en la interfaz web de GitHub.
5. Una acción de GitHub utilizará el secreto NPM_TOKEN para publicarla en NPM

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.