mcp-acronym-lookup

A lightweight, configuration-driven MCP server that ingests a CSV of acronyms and initialisms to expose a lookup tool for their full meanings and descriptions.

Purpose

`mcp-acronym-lookup` lets you turn any simple three‑column CSV file of abbreviations into an MCP server whose single tool can resolve those acronyms or initialisms, returning all matching definitions in JSON to your agent.

Releases

All official versions of mcp-acronym-lookup are published on GitHub Releases. Since this MCP server is written in Go, each release provides pre-compiled executables for macOS, Linux, and Windows—ready to download and run.

Alternatively, if you have Go installed, you can install mcp-acronym-lookup directly from source using the following command:

go install github.com/UnitVectorY-Labs/mcp-acronym-lookup@latest

Configuration

This server is configured using one environment variable and an optional command-line flag:

Environment Variables

• `ACRONYM_FILE`: (required) Path to the CSV file containing the acronym definitions. The CSV must have three columns in order: `acronym`, `full form`, and `description`.

Command‑Line Flags

• `--http `: Run in Streamable HTTP transport on the given address (for example, `:8080`). If omitted, the server runs in standard I/O mode (recommended by the MCP specification).

CSV Format

The CSV file should be UTF‑8 encoded and may include a header row. Example:

acronym,full form,description
LOL,Laugh Out Loud,Used in digital communication to indicate something is funny.
ASAP,As Soon As Possible,Commonly used to express urgency in completing a task or response.
DIY,Do It Yourself,Refers to the practice of creating or repairing things without professional help.

Run in Streamable HTTP Transport

To run as an MCP HTTP server, use the `--http ` flag (e.g., `--http :8080`). If not specified, the server defaults to stdio.

The MCP server can then be accessed at the following endpoint: `http://localhost:/mcp`

Limitations

• The server only supports one CSV file per instance.
• Matches are case‑insensitive and ignore non‑alphanumeric characters; input strings are sanitized before lookup.
• If multiple definitions exist for the same sanitized key, all definitions are returned in a list.