Esa MCP Server

🚀 esa-mcp-server

esa-mcp-server is a server that connects to the esa.io API through the Model Context Protocol (MCP).

✨ Features

• get_search_query_document: Provides documentation for searching articles on esa.io.
• search_esa_posts: Searches for articles on esa.io.
• read_esa_post, read_esa_multiple_posts: Retrieves detailed information for a single article or multiple articles.
• create_esa_post: Creates a new article.
• update_esa_post: Updates an existing article.
• delete_esa_post: Deletes a specified article.

🚀 Quick Start

Prepare the following configuration file according to the tool you are using:

{
  "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"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

## Using esa Tools

To search for information on esa, you can use the following tools:

- Use the `search_esa_posts` tool when searching for articles. If you need a complex query, first use the `get_search_query_document` tool to understand how to accurately construct the query.
- Use the `read_esa_post` and `read_esa_multiple_posts` tools to retrieve the article body. If you need to retrieve multiple articles, it is recommended to use `read_esa_multiple_posts` for batch retrieval.
- When creating, updating, or deleting an article, use the `create_esa_post`, `update_esa_post`, and `delete_esa_post` tools respectively.

📚 Documentation

Please refer to src/server.ts.

🔧 Contribution

Contributions are welcome.