Servidor MCP de Liquidium

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con los análisis de PostHog mediante Liquidium. ¡Crea anotaciones y gestiona proyectos directamente desde Claude Desktop o Smithery!

Características

• Lista de proyectos : vea todos los proyectos PostHog disponibles en su organización

• Crear anotaciones : agregue anotaciones a sus proyectos PostHog con marcas de tiempo opcionales

• Listado y búsqueda de información : vea y busque información en sus proyectos de PostHog

• Obtener detalles de información : ver información detallada sobre información específica

Related MCP server: PostHog MCP Server

Configuración

Opción 1: Herrería (Recomendada)

La forma más sencilla de utilizar Liquidium MCP es a través de Smithery:

1. Visita Liquidium MCP en Smithery

2. Haga clic en "Añadir a Claude"

3. Ingrese su clave API de PostHog cuando se le solicite

4. ¡Comienza a utilizar las herramientas Liquidium en Claude!

Opción 2: Instalación local

1. Prerrequisitos

   • Python 3.10 o superior

   • gestor de paquetes pip o uv

   • Clave API de PostHog con annotation:write y project:read obtenidos de la configuración de su proyecto

2. Instalación

   # clone the repo
   git clone https://github.com/Shudufhadzo/liquidium-mcp.git
   
   cd liquidium-mcp
   
   # Create and activate virtual environment
   python -m venv .venv
   
   # On Windows
   .venv\Scripts\activate
   
   # On macOS/Linux
   source .venv/bin/activate
   
   # Install dependencies
   pip install -e .

3. Configuración

   • Cree un archivo .env en la raíz del proyecto:

     PERSONAL_API_KEY=phx_your_posthog_api_key_here

4. Configuración del escritorio de Claude

   • Instalar Claude Desktop

   • Abra la configuración de Claude Desktop y haga clic en "Editar configuración". También puede abrir el archivo desde:

     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

     • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

   • Agregue esto a su claude_desktop_config.json (ajuste las rutas según su sistema):

     {
       "mcpServers": {
         "posthog": {
           "command": "/path/to/python",  # Get this by running: which python
           "args": [
             "-m",
             "posthog_mcp",
             "--directory",
             "/path/to/your/posthog-mcp"  # Full path to this project
           ]
         }
       }
     }

     Consulte la documentación más reciente sobre la configuración de Claude Desktop como cliente MCP si encuentra algún problema.

Uso

Tras la configuración, verá el icono de un martillo en Claude Desktop. Los siguientes comandos están disponibles:

Lista de proyectos

Pregúntale a Claude:

"List my PostHog projects"

Obtenga y busque información

Pregúntale a Claude:

"Enumerar mis estadísticas de PostHog" o "Buscar estadísticas de ingresos en mi PostHog"

Búsqueda de documentación en línea

Puedes preguntar:

• "¿Cómo puedo hacer un proxy inverso en nextjs en posthog?"

Crear anotación

Usando el ID del proyecto que obtienes de la lista de proyectos, pregúntale a Claude:

"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

o con una fecha específica:

"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

Solución de problemas

• Si el icono del martillo no aparece, reinicie Claude Desktop

• Consulte los registros en ~/Library/Logs/Claude/mcp*.log (macOS) o %APPDATA%\Claude\logs (Windows)

• Verifique que su clave API de PostHog tenga los permisos correctos

• Asegúrese de que todas las rutas en claude_desktop_config.json sean rutas absolutas

Contribuyendo

¡No dudes en publicar problemas y solicitudes de colaboración! Seguimos las normas de contribución de PostHog.