esa
About
Provides a bridge to esa's API for document management, enabling search, creation, updates, and deletion of posts and comments with member management and categorization capabilities
Details
- Author
- kajirita2002
- Repository
- kajirita2002/esa-mcp-server
- GitHub stars
- 7
- Downloads
- 445
- License
- MIT License
- Categories
- Productivity, Developer Tools, Design, Workplace, File Management, AI, Search, API, Knowledge Base, Frontend
Jump to
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
esaCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@kajirita2002/esa-mcp-server
Environment-
ESA_TEAM
your_team_name -
ESA_ACCESS_TOKEN
your_esa_access_token
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
npm install -g @kajirita2002/esa-mcp-server
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"
If you're using this MCP server, add the following configuration to your mcp_config.json file:
"esa": {
"command": "npx",
"args": ["-y", "@kajirita2002/esa-mcp-server"],
"env": {
"ESA_ACCESS_TOKEN": "your_esa_access_token",
"ESA_TEAM": "your_team_name"
}
}
Here's an example of Claude using this MCP server to create an esa post:
[Claude] Please create a new post in esa. The title should be "Project X Progress Report" and the body should include "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C".
[MCP Server] Using the esa_create_post tool to create a new post.
[Result]
{
"number": 123,
"name": "Project X Progress Report",
"body_md": "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C",
"wip": false,
"created_at": "2023-06-01T12:34:56+09:00",
"updated_at": "2023-06-01T12:34:56+09:00",
"url": "https://your-team.esa.io/posts/123"
}
[Claude] The post has been created successfully. The post number is 123, and you can access it at the following URL:
esa_list_posts
Get a list of posts in the team. Parameters: q (string, optional), include (string, optional), sort (string, optional), order (string, optional), per_page (number, optional), page (number, optional)
esa_get_post
Get detailed information about a specific post. Parameters: post_number (number, required), include (string, optional)
esa_create_post
Create a new post. Parameters: name (string, required), body_md (string, optional), tags (array of string, optional), category (string, optional), wip (boolean, optional, default: true), message (string, optional), user (string, optional), template_post_id (number, optional)
esa_update_post
Update an existing post. Parameters: post_number (number, required), name (string, optional), body_md (string, optional), tags (array of string, optional), category (string, optional), wip (boolean, optional), message (string, optional), created_by (string, optional), original_revision (string, optional)
esa_list_comments
Get a list of comments for a post. Parameters: post_number (number, required), page (number, optional), per_page (number, optional)
esa_get_comment
Get a specific comment. Parameters: comment_id (number, required), include (string, optional)
esa_create_comment
Post a comment to an article. Parameters: post_number (number, required), body_md (string, required), user (string, optional)
esa_get_members
Get a list of team members. Parameters: page (number, optional), per_page (number, optional)
esa_get_member
Get information about a specific team member. Parameters: screen_name_or_email (string, required)
This MCP server provides the following tools:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"esa": {
"env": {
"ESA_TEAM": "your_team_name",
"ESA_ACCESS_TOKEN": "your_esa_access_token"
},
"args": [
"-y",
"@kajirita2002/esa-mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": {
"ESA_TEAM": "your_team_name",
"ESA_ACCESS_TOKEN": "your_esa_access_token"
},
"args": [
"-y",
"@kajirita2002/esa-mcp-server"
],
"command": "npx"
}Macos
{
"env": {
"ESA_TEAM": "your_team_name",
"ESA_ACCESS_TOKEN": "your_esa_access_token"
},
"args": [
"-y",
"@kajirita2002/esa-mcp-server"
],
"command": "npx"
}Windows
{
"env": {
"ESA_TEAM": "your_team_name",
"ESA_ACCESS_TOKEN": "your_esa_access_token"
},
"args": [
"/c",
"npx",
"-y",
"@kajirita2002/esa-mcp-server"
],
"command": "cmd"
}esa MCP Server
Read this in Japanese
Overview
This server is an interface that uses the Model Context Protocol (MCP) to enable Claude AI to interact with the esa API.
With this MCP server, Claude AI can perform operations such as searching, creating, and updating esa documents.
<a href="https://glama.ai/mcp/servers/@kajirita2002/esa-mcp-server">
</a>
About the Repository
This repository provides a standalone implementation of the esa MCP server. It integrates Claude AI with esa to streamline document management.
Setup
Prerequisites
- Node.js 18 or higher
- esa API access token
- esa team name
Installation
```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.
