Integrations

Uses environment variables for configuration and authentication with Wordware API credentials

Software de palabras MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que integra las potentes capacidades de agente de Wordware con Claude y otros asistentes de IA compatibles con MCP.

Descripción general

Este proyecto crea un puente entre asistentes de IA como Claude y las capacidades de los agentes especializados de Wordware mediante el Protocolo de Contexto de Modelo (MCP) de Anthropic. La integración carga dinámicamente herramientas de la API de Wordware según la configuración, lo que permite a Claude acceder a cualquier flujo especializado de Wordware.

Características

🔄 Carga dinámica de herramientas : carga automáticamente herramientas desde la API de Wordware según la configuración
🧠 Detección de esquemas inteligente : detecta y se adapta automáticamente a diferentes esquemas de entrada de herramientas
🔍 Procesamiento avanzado de parámetros : maneja varios formatos de entrada (JSON, estructuras anidadas, cadenas)
⚙️ Manejo robusto de errores : registro de errores integral y gestión de bucles de eventos
🔑 Autenticación simple : configuración fácil para conectar su cuenta de Wordware

Prerrequisitos

Python 3.8+
Credenciales de la API de Wordware
Claude Desktop u otro cliente compatible con MCP

Instalación

# Clone the repository
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your Wordware API credentials

Configuración

Cree un archivo tools_config.json con la siguiente estructura:

{
  "tools": [
    {
      "id": "your-tool-id-1"
    },
    {
      "id": "your-tool-id-2"
    },
    {
      "id": "your-tool-id-3"
    }
  ]
}

Puede especificar cualquier ID de herramienta de Wordware en este archivo de configuración, y el servidor las cargará y registrará dinámicamente como herramientas MCP. Los metadatos de la herramienta, incluyendo el esquema de entrada y la descripción, se obtendrán directamente de la API de Wordware.

Para especificar una ruta de archivo de configuración personalizada, utilice la variable de entorno CONFIG_PATH .

Ejecución del servidor

# Run with default settings
python server.py

# Run with debug logging
python server.py --debug

# Run with SSE transport on a specific port
python server.py --transport sse --host 127.0.0.1 --port 8000

# Or install in Claude Desktop
mcp install python server.py --name "Wordware Tools"

Cómo funciona

El servidor MCP de Wordware funciona de la siguiente manera:

Carga de configuración de herramientas : lee la lista de ID de herramientas del archivo de configuración
Registro dinámico de herramientas : para cada ID de herramienta:
- Obtiene metadatos de la API de Wordware
- Detecta los requisitos del esquema de entrada
- Crea una función de herramienta MCP correspondiente
- Registra la herramienta con el servidor MCP
Procesamiento de solicitudes : cuando se llama a una herramienta:
- Procesa parámetros de entrada en varios formatos (objetos JSON, cadenas, estructuras anidadas)
- Adapta el formato de los parámetros según los requisitos de la herramienta.
- Envía la solicitud con el formato correcto a la API de Wordware
Manejo de respuestas : procesa las respuestas de la API de Wordware:
- Analiza el flujo de eventos enviados por el servidor (SSE)
- Recopila todos los valores de salida
- Formatea la respuesta para Claude de una manera fácil de usar.

Funciones avanzadas

Manejo inteligente de parámetros

El servidor maneja automáticamente diferentes formatos de parámetros de entrada:

Parámetros directos: {"Full Name": "John Doe", "Company": "Acme Inc."}
Cadena JSON en kwargs: {"kwargs": "{\"Full Name\": \"John Doe\", \"Company\": \"Acme Inc.\"}"}
Parámetros anidados: {"kwargs": {"Full Name": "John Doe", "Company": "Acme Inc."}}

Detección del esquema de entrada

El servidor analiza el esquema de entrada de cada herramienta para determinar el formato correcto:

Detecta si una herramienta requiere parámetros envueltos en un objeto kwargs
Extrae propiedades internas para una mejor documentación
Adapta automáticamente el formato de los parámetros para cada herramienta

Manejo y recuperación de errores

El manejo robusto de errores incluye:

Monitoreo y recuperación de bucles de eventos
Registro detallado de todas las solicitudes y respuestas
Manejo elegante de errores HTTP y tiempos de espera
Mensajes de error completos para la resolución de problemas

Solución de problemas

La herramienta no se muestra en Claude Desktop : asegúrese de que el servidor esté en ejecución y registrado correctamente en la configuración de Claude Desktop
Errores de autenticación : Verifique que su clave API de Wordware esté configurada correctamente en el archivo .env
Errores de validación de parámetros : Verifique que el formato de entrada coincida con los requisitos de la herramienta
Errores de bucle de eventos : si ve errores de "El bucle de eventos está cerrado", intente reiniciar el servidor

Desarrollo

Para ampliar o modificar el servidor:

# Run with debug logging
python server.py --debug

# Check the logs for detailed information
tail -f /path/to/your/logs/mcp.log

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

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

Expresiones de gratitud

Protocolo de contexto antrópico para el modelo
Wordware para su plataforma de agentes
SDK de Python de MCP para la implementación del protocolo

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que conecta a los asistentes de IA como Claude con las capacidades de agente especializado de Wordware, lo que permite la carga dinámica y el acceso a cualquier flujo de Wordware a través de una interfaz estandarizada.

Wordware MCP