Servidor MCP de esa

Lea esto en japonés

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

# Install globally
npm install -g @kajirita2002/esa-mcp-server

# Or use directly with npx
npx @kajirita2002/esa-mcp-server

Configuración de variables de entorno

# Set environment variables
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

Ejemplo de configuración de MCP

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

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

Iniciando el servidor

# Start the server
npm start

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas:

Publicación relacionada

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
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')
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
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

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)
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')
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

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)
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:

[Claude] Please create a new post in esa. The title should be "Project X Progress Report" and the body should include "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C".

[MCP Server] Using the esa_create_post tool to create a new post.

[Result]
{
  "number": 123,
  "name": "Project X Progress Report",
  "body_md": "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C",
  "wip": false,
  "created_at": "2023-06-01T12:34:56+09:00",
  "updated_at": "2023-06-01T12:34:56+09:00",
  "url": "https://your-team.esa.io/posts/123"
}

[Claude] The post has been created successfully. The post number is 123, and you can access it at the following URL:
https://your-team.esa.io/posts/123

Solución de problemas

Problemas con el token de acceso

Error: Request failed with status code 401

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

Error: Request failed with status code 403

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.

esa MCP Server