Servidor Coda MCP

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que actúa como puente para interactuar con la API de Coda. Permite que un cliente MCP (como un asistente de IA) realice acciones en un documento de Coda específico, como listar, crear, leer, actualizar y duplicar páginas.

Características

El servidor expone las siguientes herramientas al cliente MCP:

• list-pages : enumera todas las páginas dentro del documento Coda configurado.
• create-page : crea una nueva página en el documento y, opcionalmente, la rellena con contenido inicial en formato Markdown.
• get-page-content : recupera el contenido de una página específica (por ID o nombre) como markdown.
• update-page : reemplaza o agrega contenido de rebajas a una página específica.
• duplicate-page : crea una copia de una página existente con un nuevo nombre.

Uso

Agregue el servidor MCP a Cursor/Claude Desktop/etc. con el siguiente comando de ejecución:

Por ejemplo, en Cursor/Claude Desktop, puedes agregarlo de la siguiente manera:

Variables de entorno requeridas:

• API_KEY : Tu clave API de Coda. Puedes generarla desde la configuración de tu cuenta de Coda.
• DOC_ID : El ID del documento Coda con el que desea que el servidor interactúe. Puede encontrarlo en la URL del documento (después de d ).

Configuración local

1. Prerrequisitos:
   • Node.js
   • pnpm
2. Clonar el repositorio:
   git clone <repository-url> cd coda-mcp
3. Instalar dependencias:
   pnpm install
4. Construir el proyecto:
   pnpm build
   Esto compila el código TypeScript a JavaScript en el directorio dist/ .

Ejecución del servidor

El servidor MCP se comunica mediante la entrada/salida estándar (stdio). Para ejecutarlo, configure las variables de entorno y ejecute el archivo JavaScript compilado: dist/index.js .

Desarrollo

• Pelusa: pnpm lint
• Formato: pnpm format
• Generación de cliente OpenAPI: pnpm openapi-ts (si cambia la especificación de la API de Coda)