esa.io

esa-mcp-server

esa-mcp-server es un servidor que permite utilizar la API de esa.io a través de Model Context Protocol (MCP).

📢 Aviso importante

¡Se ha lanzado el servidor MCP local oficial de esa! 🎉

El servidor MCP oficial es multifuncional y ofrece una amplia gama de funciones, como gestión de equipos, gestión de artículos, gestión de comentarios, gestión de categorías, ayuda y documentación, recursos, prompts, etc. También recomendamos revisarlo.

Diferencias entre el oficial y este repositorio

El servidor MCP oficial y la implementación de este repositorio tienen ventajas y desventajas:

• Oficial: multifuncional y capaz de hacer muchas cosas (prompt del sistema: aproximadamente 11.3k tokens)
• Este repositorio: las funciones se limitan a herramientas de búsqueda, adición y actualización de artículos, pero con un diseño compacto (prompt del sistema: aproximadamente 3.4k tokens, menos de 1/3 en comparación con el oficial)

Recomendación

Se recomienda utilizar el servidor MCP oficial, pero dado que ejerce una gran presión sobre la ventana de contexto, se sugiere combinarlo con un enfoque de carga diferida como d-kimuson/modular-mcp, o con una operación que limite los proyectos o agregue solo cuando sea necesario.

Si no desea preocuparse por estos inconvenientes, el esa-mcp-server de este repositorio ejerce relativamente poca presión sobre el contexto, por lo que es más fácil de agregar incluso de forma independiente.

Funciones

• get_search_query_document: proporciona documentación para buscar artículos en esa.io
• search_esa_posts: búsqueda de artículos en esa.io
• read_esa_post, read_esa_multiple_posts: obtención de detalles de artículos (individual y múltiple)
• create_esa_post: creación de artículos
• update_esa_post: actualización de artículos
• delete_esa_post: eliminación de artículos

Uso

Prepare el archivo de configuración de la siguiente manera según la herramienta que utilice.

{
  "mcpServers": {
    "esa-mcp-server": {
      "command": "npx",
      "args": ["-y", "esa-mcp-server@latest"],
      "env": {
        "ESA_API_KEY": "your api key here",
        "DEFAULT_ESA_TEAM": "your default esa team"
      }
    }
  }
}

Ejemplo de prompt

## Using esa tools

esa の情報を検索するために esa 以下のツールを利用できます。

- 記事の検索には search_esa_posts ツールを利用します。複雑なクエリを利用する場合は get_search_query_document ツールで正確なクエリの記述方法を理解してから利用します。
- 記事本文を取得するには read_esa_post, read_esa_multiple_posts ツールを利用します。複数の記事を取得する必要がある場合は read_esa_multiple_posts でまとめて取得することを推奨します。
- 記事を作成/更新/削除するにはそれぞれ create_esa_post, update_esa_post, delete_esa_post ツールを利用します。

Herramientas disponibles

Consulte src/server.ts.

Contribución

Bienvenido.