Hugging Face's logo

ignorantesnaturales
/
mcp-figma-comment-summary

mcp
model-context-protocol
figma
api
design
collaboration
claude
webhooks
variables
Model card Files
xet
 Community
mcp-figma-comment-summary / HUGGINGFACE_PUBLISHING.md
IgnorantesNaturales
Add new features to MCP
1c2fe57
preview code
|
raw
history blame contribute delete
4.98 kB

Guía de Publicación en Hugging Face

📋 Prerrequisitos

  1. Cuenta en Hugging Face: https://huggingface.co/join
  2. Git instalado
  3. Git LFS instalado (opcional pero recomendado)

🚀 Método 1: Crear Space Directamente en Hugging Face

Paso 1: Crear el Space

  1. Ve a https://huggingface.co/new-space
  2. Configura:
    • Space name: mcp-figma-rest-api (o el nombre que prefieras)
    • License: MIT
    • Space SDK: Static
    • Visibility: Public

Paso 2: Clonar y Subir Contenido 

# Clonar el Space vacío
git clone https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api
cd mcp-figma-rest-api

# Copiar el README preparado para Hugging Face
cp ../mcp-figma-comment-summary/README.huggingface.md README.md

# Añadir y publicar
git add README.md
git commit -m "Add Complete Figma REST API MCP Server v2.0.0"
git push

Paso 3: Verificar

Ve a https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api y verifica que todo se vea correctamente.

🔗 Método 2: Sincronizar desde GitHub

Opción A: Importar Repositorio Existente

  1. Ve a https://huggingface.co/new-space
  2. Selecciona "Import from GitHub"
  3. Conecta tu cuenta de GitHub
  4. Selecciona tu repositorio mcp-figma-comment-summary
  5. Hugging Face clonará automáticamente

IMPORTANTE: Si usas este método, necesitas renombrar README.huggingface.md a README.md en tu repositorio de GitHub primero.

Opción B: Configurar Sincronización Bidireccional

Si quieres mantener GitHub como fuente principal y que Hugging Face se sincronice automáticamente:

# En tu repositorio local
cd /Users/fran/Documents/IN/Labs/mcp-figma-comment-summary

# Añadir Hugging Face como remote adicional
git remote add huggingface https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api

# Crear una rama específica para Hugging Face (opcional)
git checkout -b huggingface-sync

# Renombrar README para Hugging Face
mv README.md README.github.md
mv README.huggingface.md README.md

# Commit y push a Hugging Face
git add .
git commit -m "Prepare for Hugging Face deployment"
git push huggingface huggingface-sync:main

# Volver a la rama principal
git checkout main

📝 Personalizar la Página de Hugging Face

El archivo README.huggingface.md ya tiene los metadatos necesarios en el frontmatter YAML:

---
title: Figma REST API MCP Server
emoji: 🎨
colorFrom: purple
colorTo: blue
sdk: static
pinned: false
tags:
  - mcp
  - model-context-protocol
  - figma
  - api
  - design
  - collaboration
  - claude
  - webhooks
  - variables
license: mit
---

Puedes personalizar:

  • title: Nombre que aparece en Hugging Face
  • emoji: Icono del Space
  • colorFrom/colorTo: Gradiente del header
  • tags: Para búsqueda y descubrimiento
  • pinned: Si quieres que aparezca destacado en tu perfil

🔍 Verificación Post-Publicación

Después de publicar, verifica:

  1. ✅ El README se muestra correctamente
  2. ✅ Los 29 endpoints están documentados
  3. ✅ Los ejemplos de uso funcionan
  4. ✅ Los enlaces a npm y GitHub funcionan
  5. ✅ Las instrucciones de instalación son claras

📦 Actualizar en el Futuro

Cuando publiques actualizaciones:

# Si usas el método directo
cd mcp-figma-rest-api
# Actualiza README.md con los cambios
git add .
git commit -m "Update to v2.0.1"
git push

# Si sincronizas desde GitHub
git push github main
git push huggingface huggingface-sync:main

🌟 Promoción

Una vez publicado, puedes:

  1. Compartir el enlace en:

    • Twitter/X con hashtags #MCP #Figma #Claude
    • Discord de Model Context Protocol
    • Comunidad de Figma

  2. Añadir badge en tu README de GitHub:

    [![Hugging Face](https://img.shields.io/badge/🤗%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api)

  3. Enlazar desde tu perfil de npm:

    • Actualiza el homepage en package.json si quieres que apunte a Hugging Face

❓ Troubleshooting

El README no se muestra correctamente

  • Verifica que el archivo se llama exactamente README.md
  • Revisa que el frontmatter YAML esté correcto
  • Comprueba que no haya caracteres especiales mal formateados

Los cambios no se reflejan

  • Espera 1-2 minutos (Hugging Face puede tardar en actualizar)
  • Haz un hard refresh (Cmd+Shift+R en Mac, Ctrl+Shift+R en Windows)
  • Verifica que el push se completó correctamente

Error de permisos

  • Asegúrate de estar autenticado en Hugging Face
  • Configura tu token de acceso si es necesario:
    git config credential.helper store

📚 Referencias