software de palabras-mcp
El servidor MCP (Protocolo de Contexto de Modelo) de Wordware le permite ejecutar sus aplicaciones de Wordware localmente. Esto le permite integrar los potentes flujos de IA de Wordware directamente en su entorno de desarrollo local, facilitando la prueba y el desarrollo de aplicaciones que aprovechan las capacidades de Wordware.
Novedades de la versión 1.1.5
- Actualizado para funcionar con el nuevo punto final de API local ( http://localhost:9000/{WORDWARE\_API\_TOKEN} )
- Ya no es necesario especificar APP_ID: las herramientas se descubren automáticamente
- Proceso de instalación interactivo con
npx wordware-mcp - Configuración automática de Claude
- Interfaz CLI mejorada con soporte de argumentos de línea de comandos
- Especificación directa de la clave API mediante parámetros
- Manejo y registro de errores mejorados
- Soporte de instalación global con sintaxis de comandos sencilla
Instalación
La forma más sencilla de comenzar es utilizar el proceso de instalación interactivo con npx:
Esto le guiará a través de:
- Ingresando su clave API de Wordware
- Configuración de Claude (opcional)
El comando npx hará lo siguiente:
- Le solicitará detalles de configuración si no los proporciona
- Crear los archivos de configuración necesarios
- Configure su entorno local para ejecutar aplicaciones de Wordware
Después de ejecutar el comando npx, puede iniciar el servidor MCP con:
Instalación permanente
Si prefiere instalar el paquete de forma permanente:
# Install globally from npm registry
npm install -g wordware-mcp
# Or install locally in your project
npm install wordware-mcp
# Or clone this repository and install globally
git clone https://github.com/{username}/wordware-mcp.git
cd wordware-mcp
npm run install-global
Prerrequisitos
Antes de utilizar este paquete, necesitas:
- Una cuenta de Wordware (regístrese en wordware.ai )
- Una clave API de Wordware
- Al menos una aplicación Wordware implementada
Uso básico
Usando npx directamente (no requiere instalación)
Puedes ejecutar wordware-mcp usando npx sin instalarlo primero:
# Interactive mode - will prompt for required information
npx wordware-mcp
# Or with command line parameters
npx wordware-mcp --api-key your-api-key --port 3000
# Start MCP server after configuration
npx wordware-mcp start
Como comando global
Si se instala globalmente, se puede ejecutar de una de dos maneras:
# Option 1: Create an .env file in your current directory first (see Configuration section)
wordware-mcp
# Option 2: Pass parameters directly via command line
wordware-mcp --api-key your-api-key --port 3000
Opciones de línea de comandos
Options:
--api-key, -k <key> Wordware API key (required unless in .env file)
--port, -p <port> Port to run the server on (default: 3000)
--help, -h Show this help message
Como paquete en su proyecto
// In your script
import { startMCP } from "wordware-mcp";
// Start the MCP server
startMCP();
Configuración
Puede configurar el servidor MCP de dos maneras:
1. Variables de entorno o archivo .env
Crea un archivo .env con las siguientes variables:
WORDWARE_API_KEY=your-api-key
PORT=3000
2. Argumentos de la línea de comandos
Pase la configuración directamente al ejecutar el comando:
wordware-mcp -k your-api-key -p 3000
Creando su configuración de Wordware
Crear una cuenta
Para empezar, necesitarás una cuenta de Wordware. Visita wordware.ai , inicia sesión y crea una cuenta.
Crear una clave API
Para que tus flujos de Wordware sean accesibles a través de MCP, necesitarás crear una clave API. Para ello, haz clic en tu foto de perfil en la esquina superior derecha > Claves API > Crear una nueva clave > Copiar tu clave.
Crear una aplicación
Ahora es momento de ser creativo. Crea una aplicación de Wordware para lo que quieras lograr o crea una bifurcación desde la página de exploración ( https://app.wordware.ai/explore ).
Implementa tu aplicación
Para que tu aplicación se active como MCP, debes implementarla. Para ello, ve a tu aplicación. Deberías ver el botón "Implementar" en la esquina superior derecha. Luego, ve a la página de implementación.
Obtener el app_id
En la página de implementación, verás la URL de implementación: https://app.wordware.ai/explore/apps/{app_id} . Obtén tu app_id desde ahí.
Uso con Claude Desktop
Para utilizar este servidor MCP con Claude Desktop:
- Asegúrese de que Claude for Desktop esté instalado
- Modifique el archivo de configuración del escritorio de Claude ubicado en:
~/Library/Application\ Support/Claude/claude_desktop_config.json - Añade lo siguiente al archivo:
{
"mcpServers": {
"wordware": {
"command": "wordware-mcp"
}
}
}
Ejemplo completo de flujo de trabajo
A continuación se muestra un ejemplo de flujo de trabajo completo para comenzar a trabajar rápidamente:
1. Configurar e iniciar Wordware MCP
# Run the interactive setup
npx wordware-mcp
# Follow the prompts to:
# - Enter your Wordware API key
# - Configure Claude integration (if desired)
# Once configured, start the server
npx wordware-mcp start
2. Integración con su aplicación
Después de iniciar el servidor MCP, sus aplicaciones de Wordware serán accesibles en:
http://localhost:3000/api/run/{app_id}
Puede activar sus flujos de Wordware a través de solicitudes HTTP:
// Example: Calling your Wordware app from JavaScript
async function callWordwareApp() {
const response = await fetch("http://localhost:3000/api/run/your-app-id", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
// Your input data here
prompt: "Your prompt to the AI model",
// Any other parameters your Wordware app expects
}),
});
const result = await response.json();
console.log(result);
}
3. Desarrollo con recarga en caliente
Durante el desarrollo, cualquier cambio que realice en sus aplicaciones de Wordware estará disponible de inmediato: solo actualice su aplicación o realice una nueva llamada a la API.
Desarrollo
Si deseas contribuir a este paquete:
# Clone the repository
git clone https://github.com/yuhuangou/wordware-mcp.git
cd wordware-mcp
# Install dependencies
npm install
# Build the package
npm run build
# Run in development mode
npm run dev
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Solución de problemas
Problemas comunes con npx
- "Comando no encontrado" después de la instalaciónSi ve que
command not found después de instalar con npx:# Make sure the package is installed globally
npm install -g wordware-mcp
# Check your npm global path is in your PATH
npm config get prefix
# Add the resulting path + /bin to your PATH if needed
- Problemas de configuraciónSi no se detecta su configuración:
# Check if .env file exists in current directory
ls -la .env
# Manually run with parameters to bypass .env
npx wordware-mcp --api-key your-api-key
- Errores de conexión rechazadaSi ve errores de conexión al intentar usar sus aplicaciones:
# Check if server is running
lsof -i :3000
# Restart server with verbose logging
npx wordware-mcp start --verbose
- Problemas de permisosSi encuentra errores de permisos con npx:
# Run with sudo (not recommended as permanent solution)
sudo npx wordware-mcp
# Fix npm permissions
chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
Para obtener más ayuda, envíe un problema en nuestro repositorio de GitHub.
Variables de entorno
Las siguientes variables de entorno se pueden configurar en el archivo .env :
PORT - El puerto donde se ejecutará el servidor (predeterminado: 3000)WORDWARE_API_KEY - Su clave API de Wordware