D Kimuson Esa MCP Server

🚀 esa-mcp-server

The esa-mcp-server is a server that utilizes the esa.io API through the Model Context Protocol (MCP) interface.

🚀 Quick Start

✨ Features

• Search for articles on esa.io.
• Retrieve detailed information for single or multiple articles.
• Provide interfaces compliant with the MCP standard.

📦 Installation

According to the tool you are using, prepare the following configuration file:

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

💻 Usage Examples

Basic Usage

search_esa_posts

Search for articles on esa.io.

type SearchPostsParams = {
  teamName?: string;
  query: string;
  order?: "asc" | "desc";
  sort?: "created" | "updated" | "number" | "stars" | "comments" | "best_match";
  page?: number;
  perPage?: number;
}

The esa article search API returns the article content, but the MCP Server response does not include this content. This is because returning the content of all matching articles during a search would consume a significant number of tokens.

For the purpose of each parameter, please refer to the official esa API v1 documentation.

read_esa_post

Retrieve an article with a specified number.

type ReadPostParams = {
  teamName?: string;
  postNumber: number;
}

read_esa_multiple_posts

Retrieve the content of multiple articles by their numbers in batches.

type ReadMultiplePostsParams = {
  teamName?: string;
  postNumbers: number[];
}

🤝 Contribution

Contributions are welcome.