BotnBot MCP

by frocher

200 downloads Not rated yet MIT
GitHub

About

BotnBot MCP is a Model Context Protocol (MCP) server implementation for monitoring website performance and environmental impact. It tracks website availability, performance metrics, and CO2 emissions, supporting multiple monitoring periods.

Details

License
MIT

Explore

- Monitor website availability and performance
- Track CO2 emissions and environmental impact
- Get detailed metrics about website performance
- Support for multiple monitoring periods (24h, 7d, 30d)

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name BotnBot MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Clone the repository:

git clone https://github.com/yourusername/botnbot_mcp.git
cd botnbot_mcp

2. Install dependencies:

npm install

3. Create a .env file with your configuration:

API_URL=your_api_url
API_TOKEN=your_api_token

1. Build the Docker image:

docker build -t botnbot_mcp .

2. Run the container:

docker run -d \
--name botnbot_mcp \
-e API_URL=your_api_url \
-e API_TOKEN=your_api_token \
botnbot_mcp

Run the MCP server:

npm start

You can also provide configuration via command line arguments:

npm start -- --url "your_api_url" --token "your_api_token"

Run the container with environment variables:

docker run -d \
--name botnbot_mcp \
-e API_URL=your_api_url \
-e API_TOKEN=your_api_token \
botnbot_mcp

Or with command line arguments:

docker run -d \
--name botnbot_mcp \
botnbot_mcp npm start -- --url "your_api_url" --token "your_api_token"

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "botnbot mcp": {
            "botnbot_mcp": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "botnbot_mcp",
                    "."
                ]
            }
        }
    }
}

McpServers

{
    "botnbot_mcp": {
        "command": "docker",
        "args": [
            "build",
            "-t",
            "botnbot_mcp",
            "."
        ]
    }
}

A Model Context Protocol (MCP) server implementation for monitoring website performance and environmental impact.

Features

- Monitor website availability and performance
- Track CO2 emissions and environmental impact
- Get detailed metrics about website performance
- Support for multiple monitoring periods (24h, 7d, 30d)

Installation

Local Installation

1. Clone the repository:

git clone https://github.com/yourusername/botnbot_mcp.git
cd botnbot_mcp

2. Install dependencies:

npm install

3. Create a .env file with your configuration:

API_URL=your_api_url
API_TOKEN=your_api_token

Docker Installation

1. Build the Docker image:

docker build -t botnbot_mcp .

2. Run the container:

docker run -d \
--name botnbot_mcp \
-e API_URL=your_api_url \
-e API_TOKEN=your_api_token \
botnbot_mcp

Usage

Local Usage

Run the MCP server:

npm start

You can also provide configuration via command line arguments:

npm start -- --url "your_api_url" --token "your_api_token"

Docker Usage

Run the container with environment variables:

docker run -d \
--name botnbot_mcp \
-e API_URL=your_api_url \
-e API_TOKEN=your_api_token \
botnbot_mcp

Or with command line arguments:

docker run -d \
--name botnbot_mcp \
botnbot_mcp npm start -- --url "your_api_url" --token "your_api_token"

API Endpoints

- GET /monitors - List all monitors
- GET /monitor/:id/co2 - Get CO2 metrics for a specific monitor
- GET /monitor/:id/health - Get health status for a specific monitor
- GET /monitor/:id/performance - Get performance metrics for a specific monitor

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.