ECL MCP Server

This project integrates China Mobile Cloud Logging (ECL) with MCP (Model Context Protocol), providing tool capabilities for log querying, log overview, log group management, log topic management, alarm management, dashboards, and data processing.

Tools

Installation

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run ecl-mcp-server.

uvx ecl-mcp-server

Using PIP

Alternatively you can install ecl-mcp-server via pip:

pip install ecl-mcp-server

After installation, you can run it as a script using:

python -m ecl-mcp-server

Configuration

Configure for Cursor.app

One-Click Installation

Using uvx：

Using pip Installation：

Manual Configuration

Configure the MCP Server in Cursor.app's settings page,

{
  "mcpServers": {
    "ecl-journal": {
      "command": "uvx",
      "args": [
        "ecl-mcp-server",
        "your_access_key",
        "your_secret_key"
      ]
    }
  }
}

{
  "mcpServers": {
    "ecl-journal": {
      "command": "python",
      "args": [
        "-m",
        "ecl-mcp-server",
        "your_access_key",
        "your_secret_key"
      ]
    }
  }
}

Other MCP Client

• Cline. Click configuring-mcp-servers to learn how to configure.
• Cherry Studio. Click mcp-config to learn how to configure.

Customization - Launching ecl-mcp-server with Custom Arguments

ecl-mcp-server supports custom launch arguments or reading parameters from environment variables.

Usage: ecl-mcp-server [OPTIONS] ACCESS_KEY SECRET_KEY

Available arguments:

For more usage help, you can view the help documentation using the --help parameter: uvx ecl-mcp-server --help

Interaction Examples

1. How many log themes do I have?

   

2. Query original logs for a specific theme

   

Dependencies

This project relies on the following open source components. Many thanks to the open source community for their contributions! All dependencies follow their official licenses (see License Section).

• fastmcp
• mcp[cli]
• pydantic
• python-dateutil
• pytz
• typer

License

• This project is licensed under Apache-2.0. See LICENSE file for details.
• Licenses for dependencies: All dependencies follow their respective official licenses. See dependencies-licenses for details. Also refer to the project's licenses directory, which is included in the distribution package.