WhoAmI

A lightweight MCP server that tells you exactly who you are.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-whoami-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/whoami_mcp",
        "run",
        "main.py"
      ]
    }
  }
}

WhoAmI MCP Server is a lightweight MCP endpoint that returns the current system username as your name, enabling fast, synchronous responses ideal for local LLM integration.

How to use

You access WhoAmI through an MCP client by connecting to the MCP server that runs locally. Once connected, invoking the whoami tool returns the name of the current system user. This is useful for quickly identifying the active user in local workflows or when testing LLM prompts that require a user identity.

How to install

Prerequisites: you need Python installed on your system to run the server as configured below.

Clone the project repository to your machine.
Create an MCP configuration that points to the local WhoAmI MCP run script. Use the following snippet as your mcpServers configuration.

{
  "mcpServers": {
    "whoami": {
      "command": "uv",
      "args": ["--directory", "path/to/whoami_mcp", "run", "main.py"]
    }
  }
}

Run the MCP server

After you configure the MCP server, start it by executing the command that runs the server script through the MCP runner. The setup expects the uv runner with the directory pointing to the WhoAmI MCP run script.

Notes

This server is designed for local use and synchronous operation to quickly provide the current system username to local workflows and LLM integrations. Ensure your environment has access to the path you specify for path/to/whoami_mcp and that main.py exists at that location.

Available tools

whoami

Retrieves the username of the current system user as your name.