Servidor MCP de Thingiverse

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona herramientas para interactuar con la API de Thingiverse, lo que permite a los asistentes de IA buscar, explorar y recuperar modelos imprimibles en 3D.

🌟 Descripción general

Este servidor MCP encapsula la API de Thingiverse mediante Puppeteer para crear una interfaz fiable que puedan usar los asistentes de IA. Proporciona herramientas para:

Búsqueda de modelos imprimibles en 3D
Obtenga modelos 3D aleatorios
Explorar categorías
Obtenga modelos de categorías específicas

🚀 Características

🔍 Búsqueda de modelos : busca en la base de datos de Thingiverse de modelos imprimibles en 3D usando palabras clave
🗂️ Exploración de categorías : explora modelos por categorías
🎲 Modelos aleatorios : descubre modelos 3D aleatorios de Thingiverse
🌐 Acceso completo a la API : obtenga información detallada sobre los modelos, incluidas descripciones, archivos, imágenes y más
🤖 Integración del asistente de IA : diseñado para trabajar con asistentes de IA a través del Protocolo de contexto del modelo

📋 Requisitos previos

Node.js (v14 o superior)
npm o hilo
Token de API de Thingiverse

🔧Instalación

Clonar el repositorio
git clone <repository-url> cd thingiverse-mcp
Instalar dependencias
npm install
Configurar variables de entorno
# Create development environment file cp .env.example .env.development # Create production environment file cp .env.example .env.production
Configurar el token de API
- Obtenga un token de aplicación de Thingiverse desde el portal para desarrolladores de Thingiverse
- Agregue su token a los archivos .env.development y .env.production :
  APP_TOKEN=your_api_token_here

🎮 Uso

Modo de desarrollo

npm run dev

Esto inicia el servidor MCP en modo de desarrollo con recarga en caliente.

Modo de producción

npm run build
npm start

O utilice la abreviatura:

npm run prod

🔗 Integración con Claude Desktop

Para agregar este servidor MCP a Claude Desktop y habilitar las capacidades de navegación de Thingiverse:

Inicie el servidor MCP Asegúrese de que su servidor esté ejecutándose localmente o en un host remoto al que Claude Desktop pueda acceder.
Abra la configuración de Claude Desktop
- Iniciar Claude Desktop
- Haz clic en tu foto de perfil o en el icono en la parte superior derecha.
- Seleccione "Configuración" en el menú desplegable.
Vaya a la configuración de extensiones
- En la barra lateral de Configuración, haga clic en "Extensiones".
- Seleccione "Agregar MCP personalizado"

4.1 Configurar la conexión MCP

Nombre: Thingiverse MCP (o cualquier nombre que prefieras)
URL: Ingrese la URL donde se ejecuta su servidor MCP (por ejemplo, http://localhost:3000 para desarrollo local)
Haga clic en "Agregar MCP"

4.2 Alternativa Configurar la conexión MCP

Primero debe compilar el proyecto y proporcionar su ruta completa C:/.../Thingiverse/dist/index.js

"thingiverse": {
   "command": "node",
   "args": [
     "YOUR_CUSTOM_PATH/Thingiverse/dist/index.js"
   ]
 }

Habilitar el MCP
- Mueva el interruptor junto a su MCP de Thingiverse recién agregado para habilitarlo
- Claude Desktop intentará conectarse a su servidor MCP
Verificar la conexión
- Inicia una nueva conversación con Claude
- Escribe "¿Puedes ayudarme a encontrar algunos modelos 3D en Thingiverse?"
- Claude ahora debería poder usar las herramientas de Thingiverse para buscar y explorar modelos
Solución de problemas
- Si Claude no puede conectarse a su servidor MCP, verifique que:
  - El servidor está en ejecución y es accesible desde Claude Desktop
  - La URL correcta está configurada en la configuración de Claude Desktop
  - Su token API es válido y está configurado correctamente en el servidor

Ejemplos de uso con Claude

Una vez conectado, puedes pedirle a Claude que:

"Encuéntrame soportes para smartphones imprimibles en 3D en Thingiverse"
"Muéstrame algunos modelos 3D populares en la categoría de gadgets"
"Consígueme un modelo 3D al azar de Thingiverse"
"¿Qué categorías de modelos 3D están disponibles en Thingiverse?"

🧠 Herramientas disponibles

El servidor expone varias herramientas que pueden ser utilizadas por los asistentes de IA:

`get-things`

Busca modelos 3D según un término de búsqueda.

Parámetros:

term : término de búsqueda (obligatorio)
categoryId : ID de categoría opcional para limitar la búsqueda

`get-random-thing`

Recupera modelos 3D aleatorios de Thingiverse.

`get-categories`

Obtiene todas las categorías disponibles de Thingiverse.

`get-random-thing-from-category`

Obtiene modelos 3D aleatorios de una categoría específica.

Parámetros:

categorySlug : Slug de categoría (obligatorio)

🔍 Cómo funciona

El servidor utiliza Puppeteer con el complemento Stealth para interactuar con la API de Thingiverse. Este enfoque:

Maneja la autenticación a través de tokens API
Realiza solicitudes a varios puntos finales de Thingiverse
Analiza y devuelve los datos en un formato estructurado.
Expone puntos finales como herramientas MCP que pueden ser llamadas por asistentes de IA

🛠️ Estructura del proyecto

src/
  ├── class/
  │   └── thingiverser.class.ts    # Main Puppeteer client for Thingiverse API
  ├── endpoints/
  │   ├── getCategories.ts         # Get all categories
  │   ├── getRandomThing.ts        # Get random things
  │   ├── getThings.ts             # Search for things
  │   └── getThingsFromCategory.ts # Get things from a category
  ├── types/
  │   ├── category.d.ts            # Type definitions for categories
  │   ├── files.d.ts               # Type definitions for files
  │   └── things.d.ts              # Type definitions for things
  └── index.ts                     # Entry point and MCP server setup

⚙️ Desarrollo

Configuración del entorno

El servidor utiliza diferentes archivos de entorno para el desarrollo y la producción:

.env.development : se utiliza cuando se ejecuta en modo de desarrollo
.env.production : se utiliza cuando se ejecuta en modo de producción

Pruebas

Ejecute el conjunto de pruebas con:

npm test

Pelusa y formato

# Run ESLint
npm run lint

# Fix ESLint errors
npm run lint:fix

# Format code with Prettier
npm run format

📝 Notas para la implementación

Al implementar en producción:

Asegúrese de que su archivo .env.production contenga un token de API de Thingiverse válido
El proceso de compilación integrará este token en el código compilado
Utilice npm run prod para compilar e iniciar el servidor de producción

📄 Licencia

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

Thingiverse MCP Server

Integrations