Quip MCP Server

Un servidor MCP para realizar operaciones de documentos en Quip, permitiendo la interacción directa desde asistentes de IA.

GitHub
6

Documentación

Quip MCP Server

Un servidor de Model Context Protocol (MCP) para operaciones con documentos de Quip que permite la interacción directa con documentos de Quip desde asistentes de IA como Claude.

Características

  • Leer documentos: Obtener y mostrar el contenido de documentos de Quip por ID
  • Añadir contenido: Agregar contenido al final de documentos existentes
  • Anteponer contenido: Agregar contenido al inicio de documentos
  • Reemplazar contenido: Actualizar el contenido de documentos
  • Crear documentos: Soporte previsto para crear nuevos documentos (actualmente redirige a la interfaz web)

Cómo funciona

Este servidor MCP actúa como un puente entre Claude y los documentos de Quip. Funciona de la siguiente manera:

  1. Recibe solicitudes de Claude a través del protocolo MCP
  2. Ejecuta un script de Python (quip_edit_fixed.py) con los parámetros adecuados
  3. Devuelve los resultados a Claude

Requisitos previos

  • Node.js v18 o superior
  • TypeScript
  • Python con la librería quip instalada
  • Un token de acceso válido de Quip

Instalación

  1. Clona este repositorio:

    git clone https://github.com/AvinashBole/quip-mcp-server.git
cd quip-mcp-server

  2. Instala las dependencias:

    npm install

  3. Compila el proyecto:

    npm run build

  4. Configura tus ajustes de MCP:

    {
  "mcpServers": {
    "quip": {
      "command": "node",
      "args": ["path/to/quip-server/build/index.js"],
      "env": {
        "QUIP_ACCESS_TOKEN": "your-quip-access-token",
        "QUIP_BASE_URL": "https://platform.quip.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso

Una vez conectado, las siguientes herramientas MCP estarán disponibles para Claude:

  • quip_read_document: Leer un documento de Quip por su ID de hilo
  • quip_append_content: Añadir contenido a un documento
  • quip_prepend_content: Agregar contenido al inicio de un documento
  • quip_replace_content: Reemplazar el contenido de un documento
  • quip_create_document: Crear un nuevo documento (actualmente no compatible)

Ejemplo de uso en Claude:

<use_mcp_tool>
<server_name>quip</server_name>
<tool_name>quip_read_document</tool_name>
<arguments>
{
  "threadId": "YOUR_DOCUMENT_ID"
}
</arguments>
</use_mcp_tool>

Integración con el script de Python

El servidor espera un script de Python llamado quip_edit_fixed.py en la ruta especificada por la constante PYTHON_SCRIPT_PATH. Este script debe admitir las siguientes operaciones:

  • read: Leer el contenido de un documento
  • append: Añadir contenido al final de un documento
  • prepend: Agregar contenido al inicio de un documento
  • replace: Actualizar el contenido de un documento

Licencia

Licencia ISC

Autor

AvinashBole