EsaSAFE
esa の Model Context Protocol サーバー実装
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://smithery.ai/server/@d-kimuson/esa-mcp-server)
esa-mcp-server は、esa.io の API を Model Context Protocol (MCP) を介して利用できるようにするサーバーです。
📢 重要なお知らせ
[esa公式のローカルMCPサーバー](https://docs.esa.io/posts/561)がリリースされました! 🎉
公式のMCP Serverは多機能で、チーム管理、記事管理、コメント管理、カテゴリ管理、ヘルプ・ドキュメント、Resource、Promptなど幅広い機能を提供しています。そちらも確認することをおすすめします。
公式とこのリポジトリの違い
公式のMCP Serverとこのリポジトリの実装にはトレードオフがあります:
- 公式: 多機能でできることが多い(システムプロンプト: 約11.3k tokens)
- このリポジトリ: 記事の検索・追加・更新のツールに機能が限定されるが、コンパクトな設計(システムプロンプト: 約3.4k tokens, 公式比 1/3 以下)
推奨
公式の MCP Server の利用を推奨しますが、コンテキストウィンドウの圧迫が激しいため d-kimuson/modular-mcp のような遅延読み込みアプローチや、プロジェクトを限定した追加・必要な時だけ追加するといった運用とセットで利用するのがオススメです。
こういった面倒事を考えたくない場合は、このリポジトリの esa-mcp-server であれば比較的コンテキスト圧迫が激しくないため単体でも追加しやすいです。
機能
- getsearchquery_document: esa.io の記事を検索するためのドキュメンテーションの提供
- searchesaposts: esa.io の記事検索
- readesapost, readesamultiple_posts: 記事の詳細取得(単一・複数)
- createesapost: 記事の作成
- updateesapost: 記事の更新
- deleteesapost: 記事の削除
Usage
利用するツールに合わせて以下のように設定ファイルを準備してください。
{
"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"
}
}
}
}プロンプト例
## Using esa tools esa の情報を検索するために esa 以下のツールを利用できます。 - 記事の検索には search_esa_posts ツールを利用します。複雑なクエリを利用する場合は get_search_query_document ツールで正確なクエリの記述方法を理解してから利用します。 - 記事本文を取得するには read_esa_post, read_esa_multiple_posts ツールを利用します。複数の記事を取得する必要がある場合は read_esa_multiple_posts でまとめて取得することを推奨します。 - 記事を作成/更新/削除するにはそれぞれ cr
db690a96b6d0OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add esa-mcp-server -- npx -y [email protected]
{
"mcpServers": {
"esa-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (7)
3 read · 3 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
create_esa_post | write | Create a new post in esa.io. Required parameters: name. Optional parameters: body_md, tags, category, wip (default: true), message. |
delete_esa_post | destructive | Delete a post in esa.io. Required parameters: postNumber. |
get_search_query_document | read | Retrieves comprehensive documentation about esa.io search queries. Provides detailed information about available query syntax, operators, and search parameters to effectively search through esa posts. |
read_esa_multiple_posts | read | Read multiple posts in esa.io. |
read_esa_post | write | Read a post in esa.io. |
search_esa_posts | read | Search posts in esa.io. Response is paginated. |
update_esa_post | write | Update an existing post in esa.io. Required parameters: postNumber. Optional parameters: name, body_md, tags, category, wip, message. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (5 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (6)
delete_esa_post
.node-version
.prettierignore
.prettierrc.js
.release-it.json
@faker-js/faker, @modelcontextprotocol/sdk, axios, yaml, zod, @modelcontextprotocol/inspector, @redocly/cli, @types/node
Gates applied: no_behavioural_pass.
db690a96b6d0full audit observations/trust-audit/mcp-server/d-kimuson__esa.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | db690a96b6d0 | SAFE | B | 89 | first audit |
Questions
What is the Esa MCP server?
esa の Model Context Protocol サーバー実装
What tools does Esa expose?
7 in total: 3 read-only, 3 that write, and 1 that can delete or overwrite (delete_esa_post). Every one is listed on this page with its risk.
Is Esa safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Esa need?
No credential environment variables were found in its source, so it appears to need none.
How does Esa run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as esa-mcp-server at 0.1.1.
How current is this page?
The grade is for one exact copy of the source (db690a96b6d0), read on 2026-10-08. The repository is watched and re-audited when it changes.