Esa MCP Server

Un servidor MCP para el servicio de intercambio de documentos esa.io.

Documentación

[!IMPORTANT] Se ha lanzado un servidor MCP oficial. Por favor, utilice el servidor oficial en adelante.

esa公式のローカルMCPサーバーを公開しました - ReleaseNotes/2025/09/17 - docs.esa.io

esa MCP Server

Un servidor de Model Context Protocol (MCP) para esa.io.

Uso

Requisitos previos

Antes de usar este servidor MCP, necesitas generar un token de acceso personal desde tu equipo de esa.io:

Ve a https://<TEAM_NAME>.esa.io/user/applications
Crea un nuevo token de acceso personal
Copia el token para la configuración

Configuración

Puedes ejecutar el servidor mediante npx o Docker.

Usando npx

Añade la siguiente configuración a tu cliente MCP:

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@koki-develop/esa-mcp-server@latest"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

Reemplaza <your-team-name> y <your-personal-access-token> con el nombre de tu equipo y tu token de acceso personal.

Usando Docker

Si prefieres Docker, usa la siguiente configuración:

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM",
        "-e",
        "ESA_ACCESS_TOKEN",
        "ghcr.io/koki-develop/esa-mcp-server:latest"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

Modo de solo lectura

Para habilitar el modo de solo lectura que solo permite operaciones de lectura, añade la bandera --readonly.

Usando npx:

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@koki-develop/esa-mcp-server@latest",
        "--readonly"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

Usando Docker:

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM",
        "-e",
        "ESA_ACCESS_TOKEN",
        "ghcr.io/koki-develop/esa-mcp-server:latest",
        "--readonly"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

En el modo de solo lectura, solo están disponibles las siguientes operaciones:

get_posts - recuperar publicaciones
get_post - recuperar una publicación específica
get_tags - recuperar etiquetas
get_post_comments - recuperar comentarios de publicaciones

Las operaciones de escritura (create_post, update_post, delete_post, create_post_comment, update_comment, delete_comment) están deshabilitadas.

Herramientas MCP

Publicaciones
Etiquetas
Comentarios

Publicaciones

Herramienta	Descripción
`get_posts`	Recupera una lista de publicaciones del equipo de esa. Admite consultas de búsqueda, filtrado, ordenación y paginación. Devuelve metadatos de la publicación, incluidos título, contenido, etiquetas, categorías, información del autor y métricas de participación (comentarios, estrellas, observaciones). Opcionalmente incluye comentarios y stargazers con el parámetro include. Admite inclusión anidada como 'comments,comments.stargazers'. Nota: El contenido de la publicación (body_md) se trunca a 300 caracteres con un campo body_truncated que indica si se produjo truncamiento para reducir el tamaño del contexto.
`get_post`	Recupera una publicación específica del equipo de esa por número de publicación. Devuelve detalles completos de la publicación, incluidos título, contenido (markdown), etiquetas, categoría, información del autor, historial de revisiones y métricas de participación. Opcionalmente incluye comentarios y stargazers. Admite inclusión anidada como 'comments,comments.stargazers'.
`create_post`	Crea una nueva publicación en el equipo de esa. Requiere un título y opcionalmente acepta contenido, etiquetas, categoría, estado WIP y otros metadatos. Devuelve la información de la publicación creada, incluidos el número de publicación asignado y la URL.
`update_post`	Actualiza una publicación existente en el equipo de esa. Requiere un número de publicación y opcionalmente acepta contenido actualizado, etiquetas, categoría, estado WIP y otros metadatos. Devuelve la información de la publicación actualizada, incluidos los detalles de revisión.
`delete_post`	Elimina una publicación existente del equipo de esa. Requiere un número de publicación. La publicación se eliminará permanentemente y no se podrá recuperar. Devuelve un mensaje de confirmación tras la eliminación exitosa.

Etiquetas

Herramienta	Descripción
`get_tags`	Obtén una lista de todas las etiquetas utilizadas en el equipo de esa. Devuelve las etiquetas con sus nombres y el número de publicaciones a las que están adjuntas, ordenadas por número de publicaciones en orden descendente. Admite paginación.

Comentarios

Herramienta	Descripción
`get_post_comments`	Recupera una lista de comentarios para una publicación específica del equipo de esa. Requiere un número de publicación y admite paginación. Devuelve metadatos del comentario, incluidos contenido, información del autor, marcas de tiempo y métricas de participación (estrellas).
`create_post_comment`	Crea un nuevo comentario en una publicación existente del equipo de esa. Requiere un número de publicación y contenido del comentario en formato Markdown. Devuelve la información del comentario creado, incluidos ID, contenido, marcas de tiempo y detalles del autor.
`update_comment`	Actualiza un comentario existente en una publicación del equipo de esa. Requiere un ID de comentario y nuevo contenido en formato Markdown. Devuelve la información del comentario actualizado, incluidos contenido, marcas de tiempo y detalles del autor.
`delete_comment`	Elimina un comentario existente del equipo de esa. Requiere un ID de comentario. El comentario se eliminará permanentemente y no se podrá recuperar. Devuelve un mensaje de confirmación tras la eliminación exitosa.

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.