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'

2. 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í!

• https://github.com/apinetwork/piapi-mcp-server

• https://github.com/Meeting-Baas/meeting-mcp - Servidor MCP de Meeting BaaS que permite a los asistentes de IA crear bots de reuniones, buscar transcripciones y administrar datos de grabación

Expresiones de gratitud

• FastMCP está inspirado en la implementación de Python de Jonathan Lowin .

• Partes del código base fueron adoptadas de LiteMCP .

• Partes del código base se adoptaron del protocolo Model Context でSSEをやってみる.

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