Quip MCP Server

Servidor MCP Quip

Um servidor Model Context Protocol (MCP) para operações com documentos Quip que permite interação direta com documentos Quip a partir de assistentes de IA como o Claude.

Recursos

• Ler Documentos: Buscar e exibir o conteúdo de documentos Quip por ID
• Adicionar Conteúdo: Adicionar conteúdo ao final de documentos existentes
• Adicionar Conteúdo no Início: Adicionar conteúdo ao início de documentos
• Substituir Conteúdo: Atualizar o conteúdo de documentos
• Criar Documentos: Suporte planejado para criar novos documentos (atualmente redireciona para a interface web)

Como Funciona

Este servidor MCP atua como uma ponte entre o Claude e os documentos Quip. Ele funciona da seguinte forma:

1. Recebe solicitações do Claude por meio do protocolo MCP
2. Executa um script Python (quip_edit_fixed.py) com os parâmetros apropriados
3. Retorna os resultados para o Claude

Pré-requisitos

• Node.js v18 ou superior
• TypeScript
• Python com a biblioteca quip instalada
• Um token de acesso Quip válido

Instalação

1. Clone este repositório:

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

2. Instale as dependências:

   npm install
   

3. Compile o projeto:

   npm run build
   

4. Configure as configurações do seu 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

Uma vez conectado, as seguintes ferramentas MCP ficam disponíveis para o Claude:

• quip_read_document: Ler um documento Quip pelo seu ID de thread
• quip_append_content: Adicionar conteúdo a um documento
• quip_prepend_content: Adicionar conteúdo ao início de um documento
• quip_replace_content: Substituir o conteúdo de um documento
• quip_create_document: Criar um novo documento (atualmente não suportado)

Exemplo de uso no 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>

Integração com Script Python

O servidor espera um script Python chamado quip_edit_fixed.py no caminho especificado pela constante PYTHON_SCRIPT_PATH. Este script deve suportar as seguintes operações:

• read: Ler o conteúdo de um documento
• append: Adicionar conteúdo ao final de um documento
• prepend: Adicionar conteúdo ao início de um documento
• replace: Atualizar o conteúdo de um documento

Licença

Licença ISC

Autor

AvinashBole