esa MCP Server

oficial

Servidor oficial del Protocolo de Contexto de Modelo (MCP) para esa.io - versión de transporte STDIO.

¿Qué puedes hacer con Esa MCP?

  • Buscar y leer publicaciones — Encuentra publicaciones con esa_search_posts y luego obtén una específica por número con esa_get_post para ver su recuento de enlaces entrantes y las estadísticas del cuerpo.
  • Crear y editar contenido — Crea publicaciones con esa_create_post, actualízalas con esa_update_post o añade texto al final o al principio con esa_append_post y esa_prepend_post.
  • Gestionar el ciclo de vida de las publicaciones — Publica una publicación con esa_ship_post, archívala con esa_archive_post, duplícala con esa_duplicate_post o vuelve a una revisión anterior.
  • Gestionar comentarios — Enumera los comentarios de una publicación o equipo y luego créalos, actualízalos o elimínalos con esa_create_comment, esa_update_comment y esa_delete_comment.
  • Explorar categorías y equipos — Explora las rutas de categorías con esa_get_all_category_paths y consulta los detalles del equipo con esa_get_team_stats y esa_get_team_members.
  • Resumir una publicación — Usa el prompt esa_summarize_post para obtener un resumen estructurado de una publicación de un equipo determinado.

Documentación

esa MCP Server

License: MIT

日本語 | English

Servidor oficial de Model Context Protocol (MCP) para esa.io: versión con transporte STDIO.

Descripción general

Este servidor MCP ofrece una integración fluida entre los asistentes de IA y esa.io, una plataforma colaborativa de documentación. Permite a los asistentes de IA leer, crear, actualizar y gestionar documentos de esa directamente mediante Model Context Protocol.

Herramientas disponibles

Gestión de equipos

  • esa_get_teams - Obtener los equipos de esa a los que el usuario tiene acceso
  • esa_get_team_stats - Obtener estadísticas del equipo (miembros, publicaciones, comentarios, estrellas, seguimientos y usuarios activos)
  • esa_get_team_tags - Obtener todas las etiquetas utilizadas en las publicaciones del equipo, con su recuento
  • esa_get_team_members - Obtener los miembros del equipo con sus roles e información de perfil

Gestión de publicaciones

  • esa_search_posts - Buscar publicaciones en esa.io
  • esa_get_post - Obtener una publicación específica por número (incluye backlinks_count y body_md_stats con el recuento de caracteres y líneas del cuerpo)
  • esa_get_post_backlinks - Listar publicaciones que hacen referencia a una publicación específica, con paginación
  • esa_create_post - Crear una publicación nueva con etiquetas, categoría y estado WIP
  • esa_update_post - Actualizar una publicación existente (título, contenido, etiquetas, categoría y estado WIP)
  • esa_append_post - Añadir contenido al final del cuerpo de una publicación (no es necesario obtener el cuerpo actual; se guarda como una revisión nueva)
  • esa_prepend_post - Añadir contenido al principio del cuerpo de una publicación (no es necesario obtener el cuerpo actual; se guarda como una revisión nueva)

Acciones sobre publicaciones

  • esa_archive_post - Archivar una publicación moviéndola a la categoría Archived/
  • esa_ship_post - Marcar una publicación como completada estableciendo wip en false
  • esa_duplicate_post - Duplicar una publicación (crear una publicación WIP nueva con el mismo título y cuerpo; también se admite la duplicación entre equipos)
  • esa_rollback_post_revision - Revertir una publicación a una revisión especificada (el contenido restaurado se guarda como una revisión nueva; consulta el número de revisión mediante revision_number en esa_get_post)

Gestión de comentarios

  • esa_get_comment - Obtener un comentario específico por ID
  • esa_create_comment - Crear un comentario nuevo en una publicación
  • esa_update_comment - Actualizar un comentario existente
  • esa_delete_comment - Eliminar un comentario
  • esa_get_post_comments - Obtener los comentarios de una publicación específica, con paginación
  • esa_get_team_comments - Obtener los comentarios del equipo, con paginación

Gestión de categorías

  • esa_get_categories - Obtener las categorías y subcategorías de una ruta específica
  • esa_get_top_categories - Obtener todas las categorías de nivel superior de un equipo
  • esa_get_all_category_paths - Obtener todas las rutas de categorías de un equipo (con recuentos de publicaciones y compatibilidad con filtros)
    • Ideal para comprender la estructura de categorías, planificar la organización y realizar tareas de limpieza
    • Ejemplos de filtros: prefix: "dev" para categorías relacionadas con el desarrollo, match: "api" para categorías relacionadas con API

Archivos adjuntos

  • esa_get_attachment - Recuperar un archivo adjunto de publicaciones y comentarios de esa
    • Devuelve datos codificados en base64 para imágenes compatibles (JPEG, PNG, GIF, WebP) de menos de 30MB
    • Devuelve URL firmadas (válidas durante 5 minutos) para otros tipos de archivo, imágenes de mayor tamaño o cuando se especifica forceSignedUrl

Ayuda y documentación

  • esa_get_search_options_help - Obtener la documentación sobre la sintaxis de búsqueda de esa
  • esa_get_markdown_syntax_help - Obtener la documentación sobre la sintaxis Markdown de esa
  • esa_search_help - Buscar en la documentación de esa información sobre funciones y terminología

Recursos disponibles

  • esa_recent_posts - Obtener las publicaciones actualizadas recientemente del equipo de esa
    • Plantilla: esa://teams/{teamName}/posts/recent
    • Devuelve: lista JSON de publicaciones actualizadas recientemente

Prompts disponibles

  • esa_summarize_post - Resumir el contenido de una publicación de esa
    • Entrada: nombre del equipo y número de publicación
    • Salida: resumen estructurado del contenido de la publicación

Configuración del cliente MCP

Añade lo siguiente al archivo de configuración de tu cliente MCP:

Variables de entorno obligatorias

  • ESA_ACCESS_TOKEN: token de acceso
    • Ámbitos obligatorios: read write o admin:comment read:post write:post read:category read:tag read:attachment read:team read:member
    • Se recomienda PAT v2.
  • LANG: idioma de la interfaz de usuario

Ejemplo para Claude Desktop

Añade lo siguiente a claude_desktop_config.json:

Opción 1: Docker (recomendada)

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

Opción 2: npx

{
  "mcpServers": {
    "esa": {
      "command": "/Users/your-username/.nodenv/shims/npx",
      "args": ["@esaio/esa-mcp-server"],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

Nota: Sustituye /path/to/your/node por el resultado del comando which node.

Registro

Este paquete incluye registry.json en la raíz del paquete, que expone las herramientas, los recursos y los prompts registrados. Se puede utilizar mediante programación sin iniciar el servidor:

import registry from "@esaio/esa-mcp-server/registry.json" with {
  type: "json",
};

Esquema:

{
  "tools": [{ "name": "esa_get_teams" }, "..."],
  "resources": [
    {
      "name": "esa_recent_posts",
      "uriTemplate": "esa://teams/{teamName}/posts/recent"
    }
  ],
  "prompts": [{ "name": "esa_summarize_post" }]
}

El archivo se vuelve a generar mediante npm run build:registry y una comprobación de CI garantiza que esté sincronizado con el conjunto registrado.

Enlaces

Asistencia


Hecho con ❤️ por el equipo de esa