Servidor MCP de esa

Lea esto en

Descripción general

Este servidor es una interfaz que utiliza el Protocolo de contexto de modelo (MCP) para permitir que Claude AI interactúe con la API de esa .

Con este servidor MCP, Claude AI puede realizar operaciones como buscar, crear y actualizar documentos ESA.

Acerca del repositorio

Este repositorio proporciona una implementación independiente del servidor MCP de la ESA. Integra Claude AI con la ESA para optimizar la gestión de documentos.

Configuración

Prerrequisitos

• Node.js 18 o superior

• token de acceso a la API de esa

• nombre del equipo de la ESA

Instalación

Configuración de variables de entorno

Ejemplo de configuración de MCP

Si está utilizando este servidor MCP, agregue la siguiente configuración a su archivo mcp_config.json :

Iniciando el servidor

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas:

Publicación relacionada

1. esa_list_posts

   • Obtener una lista de publicaciones en el equipo

   • Aporte:

     • q (cadena, opcional): consulta de búsqueda

     • include (cadena, opcional): Datos relacionados para incluir en la respuesta (por ejemplo, 'comentarios, observadores de estrellas')

     • sort (cadena, opcional): método de ordenación (actualizado, creado, número, estrellas, relojes, comentarios, mejor coincidencia)

     • order (cadena, opcional): orden de clasificación (desc, asc)

     • per_page (número, opcional): Número de resultados por página (máximo: 100)

     • page (número, opcional): Número de página a recuperar

2. esa_get_post

   • Obtenga información detallada sobre una publicación específica

   • Aporte:

     • post_number (número, obligatorio): Número de publicación a recuperar

     • include (cadena, opcional): Datos relacionados para incluir en la respuesta (por ejemplo, 'comentarios, observadores de estrellas')

3. esa_create_post

   • Crear una nueva publicación

   • Aporte:

     • name (cadena, obligatorio): Título de la publicación

     • body_md (cadena, opcional): Cuerpo de la publicación (formato Markdown)

     • tags (matriz de cadenas, opcional): Lista de etiquetas para la publicación

     • category (cadena, opcional): categoría de publicación

     • wip (booleano, opcional, valor predeterminado: verdadero): si se debe marcar como WIP (trabajo en progreso)

     • message (cadena, opcional): Cambiar mensaje

     • user (cadena, opcional): nombre de pantalla del autor (sólo los propietarios del equipo pueden especificarlo)

     • template_post_id (número, opcional): ID de la publicación que se usará como plantilla

4. esa_update_post

   • Actualizar una publicación existente

   • Aporte:

     • post_number (número, obligatorio): Número de publicación a actualizar

     • name (cadena, opcional): Nuevo título para la publicación

     • body_md (cadena, opcional): Nuevo cuerpo para la publicación (formato Markdown)

     • tags (matriz de cadenas, opcional): Nueva lista de etiquetas para la publicación

     • category (cadena, opcional): Nueva categoría para la publicación

     • wip (booleano, opcional): si se marcará como WIP (trabajo en progreso)

     • message (cadena, opcional): Cambiar mensaje

     • created_by (cadena, opcional): nombre de pantalla del autor (solo los propietarios del equipo pueden especificarlo)

     • original_revision (cadena, opcional): Revisión en la que se basará la actualización

Comentarios relacionados

1. esa_list_comments

   • Obtener una lista de comentarios de una publicación

   • Aporte:

     • post_number (número, obligatorio): Número de publicación para obtener comentarios

     • page (número, opcional): Número de página a recuperar

     • per_page (número, opcional): Número de resultados por página (máximo: 100)

2. esa_get_comment

   • Obtener un comentario específico

   • Aporte:

     • comment_id (número, obligatorio): ID del comentario a recuperar

     • include (cadena, opcional): Datos relacionados para incluir en la respuesta (por ejemplo, 'stargazers')

3. esa_create_comment

   • Publicar un comentario en un artículo

   • Aporte:

     • post_number (número, obligatorio): Número de publicación a comentar

     • body_md (cadena, obligatoria): Cuerpo del comentario (formato Markdown)

     • user (cadena, opcional): nombre de pantalla del autor (sólo los propietarios del equipo pueden especificarlo)

Miembros relacionados

1. esa_get_members

   • Obtenga una lista de los miembros del equipo

   • Aporte:

     • page (número, opcional): Número de página a recuperar

     • per_page (número, opcional): Número de resultados por página (máximo: 100)

2. esa_get_member

   • Obtener información sobre un miembro específico del equipo

   • Aporte:

     • screen_name_or_email (cadena, obligatoria): Nombre de pantalla o correo electrónico del miembro a recuperar

Ejemplo de uso

A continuación se muestra un ejemplo de Claude utilizando este servidor MCP para crear una publicación ESA:

Solución de problemas

Problemas con el token de acceso

Si ve este error, es posible que su token de acceso de ESA no sea válido o esté caducado. Genere un nuevo token de acceso desde la pantalla de configuración de ESA y actualice su variable de entorno.

Problemas de permisos

Si ve este error, el token de acceso actual no tiene los permisos necesarios. Verifique los permisos de su token de acceso en la pantalla de configuración de esa y emita uno nuevo si es necesario.

Licencia

Proporcionado bajo la licencia MIT.