goatcounter-mcp-server

goatcounter-mcp-server

0
research_and_data

The Goatcounter MCP Server is designed to facilitate interactions with the Goatcounter web analytics API through a standardized interface. It supports various API endpoints, handles authentication via environment variables, and implements rate-limiting features. The server is suitable for integration with tools like Claude Desktop using the FastMCP library.

Overview

This project provides a Model Context Protocol (MCP) server for interacting with the Goatcounter web analytics API. It allows clients to query Goatcounter statistics using a standardized tool interface. The server is built with Python and the FastMCP library. Key features include API key handling, lazy initialization, and rate limit management.

Features

  • Tools for most Goatcounter API endpoints.
  • Configuration via environment variables.
  • Lazy API client initialization.
  • Rate limit handling with automatic retries.

Installation

  • Smithery: Use Smithery CLI to install.
  • PyPI: pip install goatcounter-mcp-server.
  • Source: Clone the repo and install dependencies.

Running the Server

  • Use the CLI script or FastMCP directly.

Usage

  • Set environment variables for configuration.
  • Use with FastMCP for tool registration with a Goatcounter prefix.

Development

  • Install development dependencies using pip.
  • Uses hatch for building.

Contributing

Contributions are welcome.

License

MIT License.