esa MCP Server
oficialServidor 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_postsy luego obtén una específica por número conesa_get_postpara ver su recuento de enlaces entrantes y las estadísticas del cuerpo. - Crear y editar contenido — Crea publicaciones con
esa_create_post, actualízalas conesa_update_posto añade texto al final o al principio conesa_append_postyesa_prepend_post. - Gestionar el ciclo de vida de las publicaciones — Publica una publicación con
esa_ship_post, archívala conesa_archive_post, duplícala conesa_duplicate_posto 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_commentyesa_delete_comment. - Explorar categorías y equipos — Explora las rutas de categorías con
esa_get_all_category_pathsy consulta los detalles del equipo conesa_get_team_statsyesa_get_team_members. - Resumir una publicación — Usa el prompt
esa_summarize_postpara obtener un resumen estructurado de una publicación de un equipo determinado.
Documentación
esa MCP Server
日本語 | 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 accesoesa_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 recuentoesa_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.ioesa_get_post- Obtener una publicación específica por número (incluyebacklinks_countybody_md_statscon 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ónesa_create_post- Crear una publicación nueva con etiquetas, categoría y estado WIPesa_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 falseesa_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 medianterevision_numberenesa_get_post)
Gestión de comentarios
esa_get_comment- Obtener un comentario específico por IDesa_create_comment- Crear un comentario nuevo en una publicaciónesa_update_comment- Actualizar un comentario existenteesa_delete_comment- Eliminar un comentarioesa_get_post_comments- Obtener los comentarios de una publicación específica, con paginaciónesa_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íficaesa_get_top_categories- Obtener todas las categorías de nivel superior de un equipoesa_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 esaesa_get_markdown_syntax_help- Obtener la documentación sobre la sintaxis Markdown de esaesa_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
- Plantilla:
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 writeoadmin:comment read:post write:post read:category read:tag read:attachment read:team read:member - Se recomienda PAT v2.
- Ámbitos obligatorios:
- 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/nodepor el resultado del comandowhich 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
- esa.io - La plataforma colaborativa de documentación
- Model Context Protocol - Más información sobre MCP
- Documentación de la API - Referencia de la API de esa.io
- Claude Desktop - Asistente de IA compatible con MCP
Asistencia
- 📧 Asistencia: Formulario de comentarios
- 🐛 Problemas: GitHub Issues
- 📖 Ayuda: Documentación de esa
Hecho con ❤️ por el equipo de esa