-
securityF
license-
qualityThis server acts as a Message Communication Protocol (MCP) service for integrating Apifox and Cursor, enabling OpenAPI interface implementation through AI-driven interaction.
Last updated -
7
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 DixaDIXA_API_BASE_URL(opcional): anula la URL de API predeterminada (el valor predeterminado es ' https://dev.dixa.io/v1 ')
Uso
Configurar variables de entorno:
export DIXA_API_KEY='your-api-key'
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
Crear un esquema en
src/schemas/Crea el recurso en
src/resources/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
Crea la herramienta en
src/tools/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 APIDixaValidationError: 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/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
Seguir los patrones existentes de recursos y herramientas
Agregue la documentación JSDoc adecuada
Utilice las utilidades compartidas en
types.tsyconfig.tsActualice el README si agrega nuevas funciones
This server cannot be installed
Related Resources
Related MCP Servers
- -securityFlicense-qualityAn 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 -141
- AsecurityFlicenseAqualityAn MCP server that integrates Apifox API documentation with AI assistants, allowing AI to extract and understand API information from Apifox projects.Last updated -218
- -securityAlicense-qualityAn MCP server that enables AI applications to interact with DiceDB databases.Last updated -5MIT License