Omi MCP Server
Servidor Omi MCP
Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Omi. El servidor proporciona herramientas para leer conversaciones y memorias, así como para crear nuevas conversaciones y memorias.
Configuración
Clonar el repositorio
Instalar dependencias con
npm installCrea un archivo
.envcon las siguientes variables:API_KEY=your_api_key APP_ID=your_app_id
Related MCP server: Omi Memories MCP Server
Uso
Instalación mediante herrería
Para instalar Omi MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @fourcolors/omi-mcp --client claudeConstruyendo el servidor
npm run buildEjecución del servidor
npm run startModo de desarrollo
Para desarrollo con recarga en caliente:
npm run devProbando el servidor
Se incluye un cliente de prueba sencillo para interactuar con el servidor MCP. Tras compilar el proyecto, ejecute:
npm run testO directamente:
./test-mcp-client.jsEsto iniciará el servidor MCP y proporcionará un menú interactivo para probar las herramientas disponibles. El cliente de prueba utiliza un ID de usuario de prueba predeterminado ( test-user-123 ) para todas las operaciones.
Limpiar y reconstruir
Para limpiar el directorio de compilación y reconstruir desde cero:
npm run rebuildConfiguración con Claude y Cursor
Configuración de Claude
Para utilizar este servidor MCP con Claude a través de Anthropic Console o API:
Inicie el servidor MCP localmente:
npm run startAl configurar su conversación de Claude, configure la conexión MCP:
{ "mcp_config": { "transports": [ { "type": "stdio", "executable": { "path": "/path/to/your/omi-mcp-local/dist/index.js", "args": [] } } ] } }Ejemplo de mensaje para Claude:
Please fetch the latest 5 conversations for user "user123" using the Omi API.Claude utilizará el MCP para ejecutar la herramienta
read_omi_conversations:{ "id": "req-1", "type": "request", "method": "tools.read_omi_conversations", "params": { "user_id": "user123", "limit": 5 } }
Configuración del cursor
Para utilizar este servidor MCP con Cursor:
Inicie el servidor MCP en una terminal:
npm run startEn Cursor, vaya a Configuración > Extensiones > Servidores MCP
Agregue un nuevo servidor MCP con estas configuraciones:
Nombre: Omi API
URL: stdio:/ruta/a/su/omi-mcp-local/dist/index.js
Habilitar el servidor
Ahora puedes usar las herramientas de Omi directamente desde Cursor. Por ejemplo:
@Omi API Please fetch memories for user "user123" and summarize them.El cursor se comunicará con su servidor MCP para ejecutar las llamadas API necesarias.
Herramientas disponibles
El servidor MCP proporciona las siguientes herramientas:
leer_conversaciones_omi
Recupera conversaciones de Omi para un usuario específico, con filtros opcionales.
Parámetros:
user_id(cadena): El ID del usuario para el que se buscarán las conversacioneslimit(número, opcional): Número máximo de conversaciones a devolveroffset(número, opcional): Número de conversaciones a omitir para la paginacióninclude_discarded(booleano, opcional): si se deben incluir las conversaciones descartadasstatuses(cadena, opcional): lista de estados separados por comas para filtrar conversaciones
leer_omi_memorias
Recupera recuerdos de Omi para un usuario específico.
Parámetros:
user_id(cadena): El ID del usuario para el que se buscarán los recuerdoslimit(número, opcional): Número máximo de memorias a devolveroffset(número, opcional): Número de memorias a omitir para la paginación
crear_conversación_omi
Crea una nueva conversación en Omi para un usuario específico.
Parámetros:
text(cadena): El contenido de texto completo de la conversaciónuser_id(cadena): El ID del usuario para el que se creará la conversacióntext_source(cadena): Fuente del contenido del texto (opciones: "audio_transcript", "message", "other_text")started_at(cadena, opcional): cuándo comenzó la conversación/evento (formato ISO 8601)finished_at(cadena, opcional): cuándo finalizó la conversación/evento (formato ISO 8601)language(cadena, opcional): Código de idioma (predeterminado: "en")geolocation(objeto, opcional): Datos de ubicación para la conversaciónlatitude(número): coordenada de latitudlongitude(número): coordenada de longitud
text_source_spec(cadena, opcional): Especificación adicional sobre la fuente
crear_recuerdos_omi
Crea nuevos recuerdos en Omi para un usuario específico.
Parámetros:
user_id(cadena): El ID del usuario para el que se crearán recuerdostext(cadena, opcional): El contenido del texto del que se extraerán las memoriasmemories(matriz, opcional): una matriz de objetos de memoria explícitos que se crearán directamentecontent(cadena): El contenido de la memoriatags(matriz de cadenas, opcional): etiquetas para la memoria
text_source(cadena, opcional): Fuente del contenido del textotext_source_spec(cadena, opcional): Especificación adicional sobre la fuente
Pruebas
Para probar el servidor MCP, puede utilizar el cliente de prueba proporcionado:
node test-mcp-client.jsEsto iniciará un cliente de prueba interactivo que le permitirá:
Obtener conversaciones
Consigue recuerdos
Crear una conversación
Abandonar
El cliente de prueba utiliza un ID de usuario de prueba predeterminado ( test-user-123 ) para todas las operaciones.
Explotación florestal
El servidor MCP incluye una función de registro integrada que escribe tanto en la consola como en un archivo de registro. Esto resulta útil para depurar y supervisar la actividad del servidor.
Ubicación del archivo de registro
Los registros se guardan en logs/mcp-server.log en el directorio del proyecto. El archivo de registro incluye marcas de tiempo e información detallada sobre:
Inicio y apagado del servidor
Todas las solicitudes y respuestas de API
Mensajes de error y seguimientos de pila
Llamadas API a Omi
Parámetros de solicitud y datos de respuesta
Visualización de registros
Puede ver los registros en tiempo real utilizando el comando tail :
tail -f logs/mcp-server.logEsto le mostrará actualizaciones en vivo a medida que el servidor procesa solicitudes e interactúa con la API de Omi.
Formato de registro
Cada entrada de registro sigue este formato:
[2024-03-21T12:34:56.789Z] Log message hereLa marca de tiempo está en formato ISO 8601, lo que facilita la correlación de eventos y la depuración de problemas.
Available Tools
4 toolscreate_omi_conversationC
Creates a new Omi conversation with text content and metadata
Inputs: text (required), text_source (required), user_id (required), finished_at, +4 more.
create_omi_memoriesB
Creates Omi memories by extracting from text or using explicit memory objects
Inputs: user_id (required), memories, text, text_source, +1 more.
read_omi_conversationsC
Retrieves user conversations from Omi with pagination and filtering options
Inputs: user_id (required), include_discarded, limit, offset, +1 more.
read_omi_memoriesB
Retrieves user memories from Omi with pagination options
Inputs: user_id (required), limit, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: create vs. read operations for two distinct resources (conversations and memories). The separation between conversations and memories is explicit, and the create/read distinction is unambiguous, leaving no room for confusion or misselection.
All tool names follow a consistent verb_noun pattern with 'create' or 'read' as the verb and 'omi_conversations' or 'omi_memories' as the noun. The naming is perfectly uniform, using snake_case throughout, making the set highly predictable and readable.
With 4 tools, the count is reasonable for a server focused on Omi conversations and memories. It covers create and read operations for both resources, which is well-scoped, though it might feel slightly thin if update or delete operations are expected in the domain, but it's not a significant issue.
The tool set provides create and read operations for both conversations and memories, covering basic CRUD elements. However, there are notable gaps: no update or delete tools for either resource, which could limit agent workflows if modifications or deletions are needed, making the surface incomplete for full lifecycle management.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Persistent memory for AI agents to retain, retrieve, and recall conversation context through MCP.
An MCP memory server. One memory your agents share — across models, devices and apps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server implementation that provides a standardized interface for applications to interact with OpenRouter's language models through a unified conversation management system.2MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that enables access to Omi memories from a specific user account through a tool interface.12ISC
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides AI agents with persistent memory capabilities through Mem0, allowing them to store, retrieve, and semantically search memories.687MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that integrates AI assistants with Mem0.ai's persistent memory system, allowing models to store, retrieve, search, and manage different types of memories.17MIT