D Kimuson Esa MCP Server

🚀 esa-mcp-server

esa-mcp-serverは、Model Context Protocol (MCP) インターフェースを通じて esa.io API を利用するサーバーです。

✨ 主な機能

• esa.ioの記事検索
• 単一または複数の記事の詳細情報の取得
• MCP標準に準拠したインターフェースの提供

📦 インストール

使用するツールに応じて、以下の設定ファイルを準備します。

{
  "mcpServers": {
    "esa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "esa-mcp-server@latest"
      ]
    },
    "env": {
      "ESA_API_KEY": "あなたのAPIキー",
      "DEFAULT_ESA_TEAM": "あなたのデフォルトのesaチーム"
    }
  }
}

💻 使用例

基本的な使用法

search_esa_posts

esa.ioの記事を検索します。

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

esaの記事検索APIは記事内容を返しますが、MCP Serverのレスポンスにはこれらの内容は含まれません。これは、検索時にすべてのヒット記事の内容を返すとトークン数が大幅に消費されるためです。 各パラメータの用途については、esa API v1 公式ドキュメント を参照してください。

read_esa_post

指定された番号の記事を取得します。

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

read_esa_multiple_posts

複数の記事番号の内容を一括で取得します。

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

🤝 貢献

貢献を歓迎します。