Skip to main content
Glama

Wakapi MCP Server

by impure0xntk
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Wakapi MCP Server

This is an MCP (Model Context Protocol) server. It provides development time tracking tools by collecting logs from Wakapi REST API.

This repository is unofficial. Use at your own risk.

Quick Start

Prerequisites

  • Python 3.11 or higher

  • Wakapi server with API access

MCP Server Configuration Examples

Quickstart with Environment Variables

{ "mcpServers": { "wakapi": { "env": { "WAKAPI_URL": "http://localhost:3000", "WAKAPI_API_KEY": "your-api-key" }, "command": "uv", "args": [ "tool", "run", "--from", "git+https://github.com/impure0xntk/mcp-wakapi", "wakapi-mcp" ] } } }

Enhanced Security with Configuration File

{ "mcpServers": { "wakapi": { "command": "uv", "args": [ "tool", "run", "--from", "git+https://github.com/impure0xntk/mcp-wakapi", "wakapi-mcp", "--config", "/path/to/config.toml" ] } } }

Features

  • Collects development time logs via the Wakapi API

  • Provides MCP tools for retrieving development data

  • Fast processing using FastMCP

  • Reproducible development environment with Nix flakes

  • Modular tool architecture

  • Improved testability through dependency injection

  • Design based on the single responsibility principle

Provided Tools

This server provides the following tools that can be used by MCP-compatible clients: Note: {api_path} is configurable: by default, /compat/wakatime/v1. Please see the Configuration section.

Tool Name

Description

API Endpoint

Get Stats

Retrieve statistics for a given user over a specified time range

GET {api_path}/users/{user}/stats/{range}

Get Projects

Retrieve and filter the user projects

GET {api_path}/users/{user}/projects

Get User

Retrieve the given user information

GET {api_path}/users/{user}

Get Leaders

Retrieve leaderboard information

GET {api_path}/leaders

Get All Time Since Today

Retrieve all time information since today

GET {api_path}/users/{user}/all_time_since_today

Get Project Detail

Retrieve detailed information about a specific project

GET {api_path}/users/{user}/projects/{id}

Get Recent Logs

Retrieve recent development logs

GET {api_path}/users/{user}/heartbeats

Test Connection

Test connection to the Wakapi server

None

Configuration Details

Environment Variables Configuration

The most common way to configure the server is through environment variables:

export WAKAPI_URL="http://your-wakapi-server:3000" export WAKAPI_API_KEY="your_actual_api_key_here" export WAKAPI_API_PATH="/compat/wakatime/v1"

Or pass to mcpServers:

{ "mcpServers": { "wakapi": { "env": { "WAKAPI_URL": "http://localhost:3000", "WAKAPI_API_KEY": "your-api-key" }, ...

Configuration Files

You can also use configuration files in TOML or JSON format:

TOML format (config.toml):

[wakapi] url = "http://your-wakapi-server:3000" api_key = "your_actual_api_key_here" api_path = "/compat/wakatime/v1" timeout = 30 retry_count = 3 [server] host = "0.0.0.0" port = 8000 [logging] level = "INFO" format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

JSON format (config.json):

{ "wakapi": { "url": "http://your-wakapi-server:3000", "api_key": "your_actual_api_key_here", "api_path": "/compat/wakatime/v1", "timeout": 30, "retry_count": 3 }, "server": { "host": "0.0.0.0", "port": 8000 }, "logging": { "level": "INFO", "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s" } }

For Developers

Setup Development Environment

This project provides a reproducible development environment using Nix flakes:

# Start the development environment nix develop # Or start a shell nix-shell

And also use uv to activate, sync and run.

Starting the MCP Server from python command

# Set environment variables export WAKAPI_URL="http://localhost:3000" export WAKAPI_API_KEY="your_actual_api_key_here" export WAKAPI_API_PATH="/compat/wakatime/v1" # Start the server in STDIO mode (default) python main.py --transport stdio # Start the server in SSE (HTTP) mode python main.py --transport sse --port 8001 # Start with a configuration file python main.py --config /path/to/config.toml

Authentication Method: The API key is automatically base64-encoded and sent as a Bearer token.

  • --transport stdio: Uses STDIO transport (default). Can be used directly with MCP clients like opencode

  • --transport sse --port 8001: Uses SSE (HTTP) transport. Accessible via browser or HTTP

Testing

You can test the server using pytest:

# Run all tests pytest # Run specific tests pytest tests/test_mcp_server.py -v

License

Apache License 2.0

Contributing

Issues and Pull Requests are welcome.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables tracking and analyzing development time through the Wakapi API. Provides tools to retrieve coding statistics, project details, leaderboards, and recent activity logs for productivity insights.

  1. Quick Start
    1. Prerequisites
    2. MCP Server Configuration Examples
  2. Features
    1. Provided Tools
      1. Configuration Details
        1. Environment Variables Configuration
        2. Configuration Files
      2. For Developers
        1. Setup Development Environment
        2. Starting the MCP Server from python command
        3. Testing
      3. License
        1. Contributing

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/impure0xntk/mcp-wakapi'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server