WhoAmI MCP Server

Developer ToolsPython

A lightweight server that returns the system username as your identity

Available Tools

whoami

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

WhoAmI is a simple yet effective tool that provides your system username as your identity. This lightweight MCP server is designed for fast, synchronous execution, making it ideal for local LLM integration. The server offers a straightforward way to retrieve the current system user's name, which can be useful for personalization in AI applications or for system identification purposes. Its minimalist approach ensures reliability and performance with minimal overhead.

Overview

WhoAmI is a lightweight MCP server that provides a simple function: it tells you exactly who you are by returning the system username. This can be useful for personalizing AI interactions or for system identification purposes.

Installation

There are multiple ways to install and use the WhoAmI MCP server:

Option 1: Install via Smithery

If you're using Claude Desktop, you can install WhoAmI automatically using Smithery:

npx -y @smithery/cli install @kukapay/whoami-mcp --client claude

Option 2: Manual Installation

Clone the repository:

git clone https://github.com/kukapay/whoami-mcp.git

Navigate to the cloned directory:

cd whoami-mcp

Install dependencies (the project uses Python 3.10+):

pip install -e .

Configure your client to use the MCP server by adding the appropriate configuration to your client's settings.

Option 3: Using Docker

The repository includes a Dockerfile, so you can build and run the server in a container:

docker build -t whoami-mcp .
docker run -p 8000:8000 whoami-mcp

Configuration

To configure your AI client to use WhoAmI, add the following to your client configuration:

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

Replace /path/to/whoami-mcp with the actual path to where you cloned the repository.

Usage

Once installed and configured, you can use the whoami tool in your AI interactions. The tool will return the username of the current system user as your identity.

License

WhoAmI is licensed under the MIT License, allowing for both personal and commercial use with minimal restrictions.