Esa MCP Server

🚀 esa-mcp-server

esa-mcp-server は、Model Context Protocol (MCP) を通じて esa.io API と接続するサーバーです。このサーバーにより、esa.io 上の記事に対する様々な操作が可能になります。

🚀 クイックスタート

esa-mcp-server を使うことで、esa.io 上の記事に対する検索、取得、作成、更新、削除などの操作が簡単に行えます。

✨ 主な機能

• get_search_query_document：esa.io 上で記事を検索するためのドキュメントを提供します。
• search_esa_posts：esa.io 上の記事を検索します。
• read_esa_post、read_esa_multiple_posts：単一の記事または複数の記事の詳細情報を取得します。
• create_esa_post：新しい記事を作成します。
• update_esa_post：既存の記事を更新します。
• delete_esa_post：指定された記事を削除します。

📦 インストール

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

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

💻 使用例

基本的な使用法

## 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` ツールを使用してください。

📚 ドキュメント

利用可能なツールについては、src/server.ts を参照してください。

🔧 コントリビューション

コントリビューションを歓迎します。