ESA MCP Server
About
ESA MCP Server is a Model Context Protocol (MCP) server that integrates with the esa.io API, built using Deno and published on JSR. It allows AI assistants to perform basic esa.io operations as MCP tools.
Details
- Author
- masseater
- Downloads
- 284
- Categories
- Other
Jump to
- Fetch user information from esa.io
- List, get, create, update, and delete articles
- Runs directly from JSR without cloning the repository
- Uses Deno runtime with explicit network permissions
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ESA MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Set environment variables ESA_TEAM_NAME and ESA_TOKEN in a .env file, then run deno run --allow-env --allow-net=api.esa.io --allow-read jsr:@masseater/esa-mcp-server. The server can also be configured as an MCP server in Cursor via .cursor/mcp.json.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"esa mcp server": {
"esa-mcp-server-masseater": {
"command": "deno",
"args": [
"run",
"--allow-env",
"--allow-net=api.esa.io",
"--allow-read",
"jsr:@masseater/esa-mcp-server"
]
}
}
}
}McpServers
{
"esa-mcp-server-masseater": {
"command": "deno",
"args": [
"run",
"--allow-env",
"--allow-net=api.esa.io",
"--allow-read",
"jsr:@masseater/esa-mcp-server"
]
}
}ESA MCP Server
esa.io API と連携するための Model Context Protocol (MCP) サーバーです。
Deno と JSR を使用して公開されています。
機能
現在、以下の基本的な esa.io API 操作を MCP ツールとして提供しています：
ユーザー情報の取得
記事一覧の取得
記事詳細の取得
記事の作成
記事の更新
記事の削除
使い方 (JSR からの実行)
JSR (JavaScript Registry) に公開されているため、ローカルにリポジトリをクローンすることなく、直接 MCP サーバーを実行できます。
前提条件 (Prerequisites)
Deno v2.0 以降がインストールされていること。(Deno v2.0 or later installed.)
インターネット接続。(Internet connection.)
セットアップ (Setup)
1. 環境変数の設定 (Set up environment variables):
サーバーを実行したいディレクトリ（通常はプロジェクトのワークスペースルート）に .env ファイルを作成し、以下の内容を記述します。(Create a .env file in the directory where you want to run the server (usually the project workspace root) and add the following content:)
# .env
ESA_TEAM_NAME="YOUR_ESA_TEAM_NAME" # Replace with your esa.io team name
ESA_TOKEN="YOUR_ESA_API_TOKEN" # Replace with your esa.io API access token
YOUR_ESA_TEAM_NAME と YOUR_ESA_API_TOKEN を実際の値に置き換えてください。(Replace YOUR_ESA_TEAM_NAME and YOUR_ESA_API_TOKEN with your actual values.)
esa.io API トークンの発行方法:
あなたの esa.io チームのページにアクセスします (例: https://<your-team-name>.esa.io/)。
右上の自分のアイコンをクリックし、「設定 (Settings)」>「アプリケーション」を選択します。
「個人用アクセストークン (Personal access tokens)」セクションで、「新しいトークンを発行する (Generate new token)」をクリックします。
トークン名 (例: mcp-server) を入力し、必要な権限スコープを選択します。この MCP サーバーには少なくとも以下の権限が必要です:
read (記事の読み取り)
write (記事の作成・更新・削除)
read_user (ユーザー情報の取得)
「発行する (Generate token)」をクリックします。
表示されたトークンを必ずコピーして安全な場所に保管してください。このトークンは一度しか表示されません。
コピーしたトークンを、上記 .env ファイルの ESA_TOKEN の値として貼り付けます。
実行 (Running)
以下のコマンドを実行します。(Run the following command:)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
