local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables integration with Windsurf IDE (a Codeium product), allowing developers to interact with Dust AI agents directly from their development environment

Servidor de polvo MCP

Este repositorio contiene la implementación de un servidor de Protocolo de Contexto de Modelo (MCP) diseñado para interactuar con los agentes de Dust. El servidor se divide en dos componentes principales: el servidor MCP (que gestiona las interacciones con la API de Dust) y el cliente de pruebas MCP (que proporciona una interfaz web para las pruebas).

Tabla de contenido

Servidor de polvo MCP

Características

Componentes separados del servidor MCP y del cliente de prueba
Interacción con los agentes de Dust AI a través de la API de Dust
Respuestas de transmisión en tiempo real mediante eventos enviados por el servidor (SSE) y transporte de transmisión HTTP
Compatibilidad completa con JSON-RPC 2.0 con los métodos 'inicializar', 'mensaje', 'terminar' y 'ejecutar'
Ejecución directa de la herramienta a través del método 'ejecutar' para una integración simplificada del cliente
Gestión robusta de sesiones y preservación del contexto
Manejo seguro de claves API con enmascaramiento de PII en registros
Mecanismo de latido para mantener conexiones persistentes
Reconexión automática para conexiones interrumpidas
Gestión y generación de informes de errores integrales
Compatibilidad con la última especificación MCP (26/03/2025)
Puntos finales de estado para monitoreo y controles de salud

Arquitectura

El servidor MCP Dust está construido utilizando los siguientes componentes:

Figura 1: Arquitectura del servidor MCP que muestra los componentes del servidor y del cliente

Servidor MCP (server.ts) :
- Maneja las interacciones del protocolo MCP con la API de Dust
- Gestiona el estado y el contexto de la sesión.
- Implementa el ciclo de vida completo de MCP (inicializar, enviar mensaje, finalizar)
- Admite transporte de flujo SSE y HTTP
- Proporciona puntos finales de estado para la monitorización
Cliente de prueba MCP (client.ts) :
- Proporciona una interfaz web para realizar pruebas.
- Permite la interacción con el servidor MCP
- Admite transmisión y depuración en tiempo real
- Incluye gestión de sesiones y seguimiento de conexiones.

Dust.tt Inteligencia Artificial Agente

Dust.tt es una plataforma diseñada para ayudar a las organizaciones a crear e implementar agentes de IA personalizados, adaptados a sus necesidades específicas. Integra modelos de IA avanzados, como GPT-4, Claude, Gemini y Mistral, con funciones de seguridad de nivel empresarial para optimizar flujos de trabajo, automatizar tareas y mejorar la productividad en diversas funciones empresariales.

Figura 2: Captura de pantalla de la interfaz de la plataforma Dust.tt que muestra las capacidades del agente

Agentes de IA personalizados : Agentes personalizados: cree agentes con instrucciones y herramientas personalizadas, adaptadas a las necesidades del equipo o del individuo.

Contexto de la empresa : integre agentes con herramientas internas como Notion, Slack, GitHub o API externas para un acceso fluido a los datos de la empresa.

Flujos de trabajo de múltiples agentes : combine y encadene múltiples agentes, cada uno con capacidades únicas, en un solo flujo de trabajo.

Integración con fuentes de datos : Conexiones de datos: conecte a los agentes con datos de SharePoint, Zendesk, Jira, Salesforce, Snowflake y más.

Consulta dinámica : utilice agentes para analizar hojas de cálculo, bases de datos y almacenes con lenguaje natural o consultas SQL.

Actualizaciones en tiempo real : sincronice el conocimiento de la empresa continuamente para obtener respuestas actualizadas.

Código abierto : Disponible en GitHub bajo la licencia MIT. Con una gran comunidad de usuarios y desarrolladores.

Hospedaje : SaaS o opción de hospedaje propio en su propio servidor

Instalación

Prerrequisitos

Node.js (recomendado: última versión LTS instalada a través de nvm )
npm (viene con Node.js)
Mecanografiado

Pasos

Clonar el repositorio:
git clone https://github.com/ma3u/mcp-dust-server.git cd mcp-dust-server
Instalar dependencias:
npm install
Configurar variables de entorno: Cree un archivo .env en el directorio raíz basado en .env.example :
# Startup Mode (server, client, or both) START_MODE=both # MCP Server Configuration MCP_NAME=Dust MCP Server JS MCP_HOST=127.0.0.1 MCP_PORT=5001 MCP_TIMEOUT=30 # seconds # MCP Test Client Configuration CLIENT_HOST=127.0.0.1 CLIENT_PORT=6001 # Dust API Configuration DUST_API_KEY=your_dust_api_key_here DUST_WORKSPACE_ID=your_workspace_id_here DUST_AGENT_ID=your_agent_id_here DUST_DOMAIN=https://dust.tt # User Context Information (used in Dust API requests) DUST_USERNAME=your_username DUST_EMAIL=your_email@example.com DUST_FULLNAME=Your Full Name DUST_TIMEZONE=Europe/Berlin

Iniciar el servidor y el cliente

Puedes ejecutar el servidor MCP y el cliente de prueba por separado o en conjunto. El proyecto proporciona varios scripts npm para diferentes escenarios:

Inicie tanto el servidor como el cliente :
npm run start
Iniciar solo el servidor MCP :
npm run start:server
Iniciar solo cliente de prueba :
npm run start:client

Resultado esperado

Si todo está configurado correctamente, debería ver un resultado similar a este:

Para el servidor MCP :

MCP Server running on http://127.0.0.1:5001 (timeout: 30s)
Server name: Dust MCP Bridge
Dust workspace: your_workspace_id
Dust agent: your_agent_id

Para el cliente de prueba :

MCP Test Client running on http://127.0.0.1:6001

Puntos finales de API

El servidor proporciona varios puntos finales para las comprobaciones de estado y la comunicación mediante el protocolo MCP. Para obtener documentación detallada de la API, consulte la documentación para desarrolladores .

Los puntos finales clave incluyen:

Controles de salud : /health , /ready , /live
Protocolo MCP : /sse (eventos enviados por el servidor), /stream (transporte de flujo HTTP)

Depuración

Para obtener información detallada sobre las herramientas y técnicas de depuración, incluido el Inspector MCP, consulte la Documentación para desarrolladores .

Solución de problemas de conexión

Si tiene problemas de conexión con MCP Inspector u otros clientes, consulte estos problemas comunes:

Falta de coincidencia en la configuración del puerto : asegúrese de que su archivo .env tenga configuraciones de puerto consistentes (MCP_PORT, MCP_MIN_PORT, MCP_MAX_PORT)
Modo de transporte : para Claude Desktop o MCP Inspector con transporte stdio, configure TRANSPORT_MODE=stdio en su .env
Encabezados de respuesta múltiples : si ve errores "ERR_HTTP_HEADERS_SENT", verifique si el middleware envía múltiples respuestas

Para obtener una guía completa de solución de problemas, consulte la sección Solución de problemas comunes en la Documentación para desarrolladores.

Integración

Configuración de Windsurf IDE

Para integrar el servidor Dust MCP con Windsurf IDE, actualice el archivo de configuración ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "dust-mcp": {
      "command": "npm",
      "args": [
        "run",
        "start:server"
      ],
      "env": {
        "DUST_API_KEY": "${YOUR_API_KEY}",
        "DUST_WORKSPACE_ID": "${YOUR_WORKSPACE_ID}",
        "DUST_AGENT_ID": "${YOUR_AGENT_ID}"
      },
      "host": "127.0.0.1",
      "port": 5001,
      "timeout": 30000
    }
  }
}

Integración de escritorio de Claude

Para integrar el servidor Dust MCP con Claude Desktop, actualice su archivo de configuración:

{
  "mcpServers": {
    "dust-agent": {
      "command": "npm",
      "args": [
        "run",
        "start:server"
      ],
      "cwd": "path/to/mcp-dust-server",
      "host": "127.0.0.1",
      "port": 5001,
      "timeout": 30000,
      "env": {
        "DUST_API_KEY": "${YOUR_API_KEY}",
        "DUST_WORKSPACE_ID": "${YOUR_WORKSPACE_ID}",
        "DUST_AGENT_ID": "${YOUR_AGENT_ID}"
      }
    }
  }
}

Pruebas

El proyecto incluye herramientas de prueba web y de línea de comandos. Para obtener información detallada sobre las pruebas, consulte la Documentación para desarrolladores .

Se puede acceder al cliente de prueba basado en web en http://localhost:6001 cuando ejecuta el componente cliente, lo que le permite interactuar con su agente Dust y probar la funcionalidad del servidor MCP.

Descripción general de la API

El servidor proporciona varios puntos finales para las comprobaciones de estado y la comunicación mediante el protocolo MCP. Para obtener documentación detallada de la API, consulte la documentación para desarrolladores .

Documentación para desarrolladores

Para obtener información técnica detallada, incluida la estructura del proyecto, la documentación de API, herramientas de depuración y consideraciones de seguridad, consulte la Documentación para desarrolladores .

Licencia

Este proyecto está licenciado bajo la licencia MIT .

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite la interacción con agentes de Dust AI, lo que permite la integración con entornos de desarrollo como Windsurf IDE y Claude Desktop.

Appeared in Searches

How to search for Facebook profiles