mcp-acronym-lookup

by UnitVectorY-Labs

222 downloads
Not rated
GitHub

About

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.

Details

Author
UnitVectorY-Labs
Downloads
222
Categories
Other

- Single tool resolves acronyms and initialisms from a CSV file.
- Returns all matching definitions as JSON.
- Case‑insensitive matching; ignores non‑alphabetic characters.
- Supports only one CSV file per server instance.
- Runs in stdio mode by default, with optional SSE mode.

Set the required ACRONYM_FILE environment variable to the path of a three‑column CSV (acronym, full form, description). By default the server runs in stdio mode; pass the --sse <addr> flag (e.g., :8080) to run in SSE mode with endpoints at /mcp/sse and /mcp/message.

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.

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

--sse <addr>: Run in SSE (HTTP/SSE) mode on the given address (for example, :8080). If omitted, the server runs in standard I/O mode.

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 SSE Mode

By default the server runs in stdio mode, but if you want to run in SSE mode, you can specify the --sse command line flag specifying the server name and port (ex: localhost:8080). This will run with the following endpoints that your MCP client can connect to:

- SSE Endpoint: /mcp/sse
- Message Endpoint: /mcp/message

Limitations

The server only supports one CSV file per instance.
Matches are case‑insensitive and ignore non‑alphabetic characters; input strings are sanitized before lookup.

  • If multiple definitions exist for the same sanitized key, all definitions are returned in a list.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.