Esa MCP Server 57l

🚀 ESA MCP Server

This is an MCP server that provides services through the esa API, enabling efficient interaction with esa's features.

🚀 Quick Start

✨ Features

This MCP server leverages the esa API to achieve the following functions:

• Retrieve team information
• Obtain a list of articles
• Get detailed information about an article
• Create a new article
• Update an existing article
• Fetch the list of article comments
• Create a new comment
• Get team statistics
• Retrieve the list of members
• Obtain the list of tags
• Get category information
• Fetch authenticated user information

📦 Installation

Step 1: Install Dependencies

Run the following command in the terminal:

bundle install

Step 2: Obtain an esa Access Token

Follow these steps to get an access token:

1. Log in to esa.
2. Visit the user settings page (https://[team-name].esa.io/user/applications).
3. Click "New Token" in the "Personal access tokens" section.
4. Enter a token name and select the scope of permissions (it is recommended to select both read and write permissions).
5. Click the "Create" button.
6. Copy the generated access token.

Step 3: Configure the MCP Server

In the directory where the esa_mcp_server.rb file is located, set the access token and team name through environment variables. Then, add the following content to the Cline MCP configuration file:

{
  "mcpServers": {
    "esa": {
      "command": "ruby",
      "args": ["/path/to/esa_mcp_server.rb"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Step 4: Add the Configuration to the Cline Settings File

Update the content of claire_mcp_settings.json in the following paths according to your operating system or IDE:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• VSCode Extension: ~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

💻 Usage Examples

Basic Usage

Here are the available tools and their functions:

• get_team: Retrieve team information
• list_posts: Obtain a list of articles
• get_post: Get detailed information about an article
• create_post: Create a new article
• update_post: Update an existing article
• list_comments: Fetch the list of article comments
• create_comment: Create a new comment
• get_stats: Get team statistics
• list_members: Retrieve the list of members
• list_tags: Obtain the list of tags
• get_user_info: Fetch authenticated user information

Advanced Usage

Example 1: Retrieve Team Information

<access_mcp_resource>
  <server_name>esa</server_name>
  <uri>teams://[team-name]</uri>
</access_mcp_resource>

Example 2: Create a New Article

<invoke_mcp_tool>
  <tool_name>create_post</tool_name>
  <parameters>
    <title>My New Article</title>
    <content>This is my first article.</content>
  </parameters>
</invoke_mcp_tool>

Example 3: Get Category Information

<access_mcp_resource>
  <server_name>esa</server_name>
  <uri>categories://Development</uri>
</access_mcp_resource>