Skip to main content
Glama
Dixa MCP Server

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

Related MCP server: ReActMCP Web Search

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      144
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      An MCP server that integrates Apifox API documentation with AI assistants, allowing AI to extract and understand API information from Apifox projects.
      2
      42 npm
      ISC