esa.io API
About
Integrates with esa.io API for searching and retrieving team knowledge, enabling efficient information access and collaboration.
Details
- Author
- d-kimuson
- Repository
- d-kimuson/esa-mcp-server
- GitHub stars
- 36
- Downloads
- 904
- License
- MIT License
- Categories
- Productivity, Other, Knowledge Base, API, Developer Tools, Design, Workplace, File Management, AI, Search, Communication, Infrastructure
Jump to
- Search articles with search_esa_posts
- Read single or multiple articles
- Create, update, and delete articles
- Provides query syntax documentation via get_search_query_document
- Compact design (system prompt ~3.4k tokens)
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.io APICommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
esa-mcp-server@latest
Environment-
ESA_API_KEY
your api key here -
DEFAULT_ESA_TEAM
your default esa team
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
利用するツールに合わせて以下のように設定ファイルを準備してください。
{
"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"
}
}
}
}
get_search_query_document
Provides documentation to search articles on esa.io.
search_esa_posts
Search for articles on esa.io.
read_esa_post
Retrieve details of a single article on esa.io.
read_esa_multiple_posts
Retrieve details of multiple articles on esa.io.
create_esa_post
Create a new article on esa.io.
update_esa_post
Update an existing article on esa.io.
delete_esa_post
Delete an article on esa.io.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"esa.io api": {
"env": {
"ESA_API_KEY": "your api key here",
"DEFAULT_ESA_TEAM": "your default esa team"
},
"args": [
"-y",
"esa-mcp-server@latest"
],
"command": "npx"
}
}
}Linux
{
"env": {
"ESA_API_KEY": "your api key here",
"DEFAULT_ESA_TEAM": "your default esa team"
},
"args": [
"-y",
"esa-mcp-server@latest"
],
"command": "npx"
}Macos
{
"env": {
"ESA_API_KEY": "your api key here",
"DEFAULT_ESA_TEAM": "your default esa team"
},
"args": [
"-y",
"esa-mcp-server@latest"
],
"command": "npx"
}Windows
{
"env": {
"ESA_API_KEY": "your api key here",
"DEFAULT_ESA_TEAM": "your default esa team"
},
"args": [
"/c",
"npx",
"-y",
"esa-mcp-server@latest"
],
"command": "cmd"
}esa-mcp-server は、esa.ioの API をModel Context Protocol (MCP)を介して利用できるようにするサーバーです。
公式のMCP Serverは多機能で、チーム管理、記事管理、コメント管理、カテゴリ管理、ヘルプ・ドキュメント、Resource、Promptなど幅広い機能を提供しています。そちらも確認することをおすすめします。
- 公式: 多機能でできることが多い（システムプロンプト: 約11.3k tokens）
- このリポジトリ: 記事の検索・追加・更新のツールに機能が限定されるが、コンパクトな設計（システムプロンプト: 約3.4k tokens, 公式比 1/3 以下）
公式の MCP Server の利用を推奨しますが、コンテキストウィンドウの圧迫が激しいためd-kimuson/modular-mcpのような遅延読み込みアプローチや、プロジェクトを限定した追加・必要な時だけ追加するといった運用とセットで利用するのがオススメです。
こういった面倒事を考えたくない場合は、このリポジトリの esa-mcp-server であれば比較的コンテキスト圧迫が激しくないため単体でも追加しやすいです。
- 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" } } } }
## Using esa tools 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 ツールを利用します。
Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.
Interact with your Anytype data through its API, enabling AI assistants to access your information.
MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.
Markdown-first Notion MCP server with 9 composite tools, 39 actions, and ~77% token reduction via tiered docs.
AI-powered reading triage MCP. 26 tools with a 24h burn timer. Read less, absorb more.
Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.
Interact with the Coda API to manage documents and pages, including creating, reading, updating, and deleting.
An MCP server that enables AI assistants to interact with Confluence content through a standardized interface.
An MCP server for document ingestion, chunking, semantic search, and note management.
Remote MCP server for Docsie video-to-docs automation and workspace knowledge search.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
