mcp-acronym-lookup

mcp-acronym-lookup

頭字語やイニシャリズムのCSVを取り込み、その正式名称と説明を検索するツールを提供する、軽量で設定駆動型のMCP サーバーです。

目的

mcp-acronym-lookupを使うと、3列のシンプルなCSVファイルを、頭字語やイニシャリズムを解決し、一致するすべての定義をJSONでエージェントに返す単一ツールを備えたMCP サーバーに変換できます。

リリース

mcp-acronym-lookupのすべての公式バージョンは、GitHub Releasesで公開されています。このMCP サーバーはGoで記述されているため、各リリースではmacOS、Linux、Windows向けのコンパイル済み実行ファイルが提供され、ダウンロードしてすぐに実行できます。

また、Goがインストールされている場合は、次のコマンドを使ってソースからmcp-acronym-lookupを直接インストールできます。

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

設定

このサーバーは、1つの環境変数と省略可能なコマンドラインフラグを使って設定します。

環境変数

• ACRONYM_FILE：（必須） 頭字語の定義を含むCSVファイルへのパスです。CSVには、acronym、full form、descriptionの順に3列が必要です。

コマンドラインフラグ

• --http <addr>：指定したアドレス（例：:8080）でStreamable HTTPトランスポートを使って実行します。省略した場合、サーバーは標準入出力モードで実行されます（MCP仕様で推奨）。

CSV形式

CSVファイルはUTF‑8でエンコードし、ヘッダー行を含めることもできます。例：

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.

Streamable HTTPトランスポートで実行する

MCP HTTPサーバーとして実行するには、--http <addr>フラグ（例：--http :8080）を使用します。指定しない場合、サーバーはstdioをデフォルトとして使用します。

MCP サーバーには、次のエンドポイントからアクセスできます：http://localhost:<port>/mcp

制限事項

• インスタンスごとにサポートされるCSVファイルは1つだけです。
• 一致検索では大文字と小文字を区別せず、英数字以外の文字を無視します。検索前に入力文字列はサニタイズされます。
• サニタイズ後のキーが同じ定義が複数ある場合、すべての定義がリストで返されます。