Dixa MCP Server

by ktabori

Servidor Dixa MCP

Una implementación de servidor FastMCP para la API Dixa, que proporciona recursos y herramientas para administrar conversaciones y etiquetas.

Características

  • Recursos
    • Buscar conversaciones
    • Obtener detalles de la conversación
    • Obtener notas de conversación
    • Recibir mensajes de conversación
    • Obtener etiquetas disponibles
  • Herramientas
    • Agregar etiquetas a las conversaciones
    • Eliminar etiquetas de las conversaciones

Estructura del proyecto

/src ├── dixa.ts # Main server setup ├── config.ts # Configuration and environment settings ├── types.ts # Shared types and error handling ├── resources/ # Resource implementations ├── schemas/ # Zod schemas for validation └── tools/ # Tool implementations

Configuración

El servidor requiere las siguientes variables de entorno:

  • DIXA_API_KEY : Su clave API de Dixa
  • DIXA_API_BASE_URL (opcional): anula la URL de API predeterminada (el valor predeterminado es ' https://dev.dixa.io/v1 ')

Uso

  1. Configurar variables de entorno:
export DIXA_API_KEY='your-api-key'
  1. Iniciar el servidor:
    npm start
## Running Your Server ### Test with `mcp-cli` The fastest way to test and debug your server is with `fastmcp dev`: ```bash npx fastmcp dev server.js npx fastmcp dev server.ts

Esto ejecutará su servidor con mcp-cli para probar y depurar su servidor MCP en la terminal.

Inspeccionar con MCP Inspector

Otra forma es utilizar el MCP Inspector para inspeccionar su servidor con una interfaz web:

npx fastmcp inspect server.ts

Preguntas frecuentes

¿Cómo utilizar con Claude Desktop?

Siga la guía https://modelcontextprotocol.io/quickstart/user y agregue la siguiente configuración:

{ "mcpServers": { "my-mcp-server": { "command": "npx", "args": [ "tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts" ], "env": { "YOUR_ENV_VAR": "value" } } } }

Desarrollo

Agregar un nuevo recurso

  1. Crear un esquema en src/schemas/
  2. Crea el recurso en src/resources/
  3. Agregue el recurso a src/dixa.ts

Recurso de ejemplo:

export const myResource = { uri: "dixa://my-resource", name: "My Resource", description: "Description", load: async (args: MyArgs, apiKey: string) => { // Implementation } };

Agregar una nueva herramienta

  1. Crea la herramienta en src/tools/
  2. Añade la herramienta a src/dixa.ts

Herramienta de ejemplo:

export const myTool = { name: "My Tool", description: "Description", execute: async (args: MyArgs, apiKey: string) => { // Implementation } };

Manejo de errores

El proyecto utiliza clases de error personalizadas:

  • DixaError : Clase de error base para errores de API
  • DixaValidationError : Para errores de validación de respuesta

Escaparate

[!NOTA]

Si ha desarrollado un servidor utilizando FastMCP, ¡ envíe un PR para mostrarlo aquí!

Expresiones de gratitud

Contribuyendo

  1. Seguir los patrones existentes de recursos y herramientas
  2. Agregue la documentación JSDoc adecuada
  3. Utilice las utilidades compartidas en types.ts y config.ts
  4. Actualice el README si agrega nuevas funciones
-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Una implementación de servidor FastMCP para la API Dixa, que permite a los asistentes de IA buscar, recuperar y administrar datos y etiquetas de conversaciones de clientes.

  1. Características
    1. Estructura del proyecto
      1. Configuración
        1. Uso
          1. Manejo de errores
            1. Escaparate
              1. Expresiones de gratitud
                1. Contribuyendo

                  Related MCP Servers

                  • A
                    security
                    F
                    license
                    A
                    quality
                    This server provides access to the Perplexity AI API, enabling interaction through chatting, searching, and documentation retrieval within MCP-based systems.
                    Last updated -
                    5
                    2
                    JavaScript
                  • -
                    security
                    F
                    license
                    -
                    quality
                    An MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.
                    Last updated -
                    119
                    Python
                    • Linux
                    • Apple
                  • -
                    security
                    -
                    license
                    -
                    quality
                    An MCP server that integrates Apifox API documentation with AI assistants, allowing AI to extract and understand API information from Apifox projects.
                    Last updated -
                    91
                    TypeScript
                  • -
                    security
                    F
                    license
                    -
                    quality
                    An MCP server that connects AI assistants to SearchAgora, enabling users to search for, discover, and purchase products across the web through natural language conversations.
                    Last updated -
                    Python
                    • Apple

                  View all related MCP servers

                  ID: pag7zu8nb8