mcp-acronym-lookup

mcp-acronym-lookup

一个轻量、由配置驱动的 MCP 服务，可导入包含首字母缩略词和首字母组合词的 CSV 文件，并提供一个查询工具来获取它们的完整含义和描述。

用途

mcp-acronym-lookup 可将任意简单的三列 CSV 缩写文件转换为 MCP 服务。该服务提供单个工具，可解析这些首字母缩略词或首字母组合词，并以 JSON 格式向你的 Agent 返回所有匹配的定义。

发布版本

mcp-acronym-lookup 的所有官方版本均发布在 GitHub Releases 上。由于此 MCP 服务使用 Go 编写，每个发布版本都提供适用于 macOS、Linux 和 Windows 的预编译可执行文件，可直接下载并运行。

或者，如果你已安装 Go，可以使用以下命令直接从源代码安装 mcp-acronym-lookup：

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

配置

此服务通过一个环境变量和一个可选的命令行标志进行配置：

环境变量

• ACRONYM_FILE：**（必填）**包含缩略词定义的 CSV 文件路径。CSV 必须依次包含三列：acronym、full form 和 description。

命令行标志

• --http <addr>：在指定地址上通过 Streamable HTTP 传输运行（例如，:8080）。如果省略，服务将以标准输入/输出模式运行（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）。如果未指定，服务默认使用标准输入/输出模式。

随后可通过以下端点访问 MCP 服务：http://localhost:<port>/mcp

限制

• 每个实例仅支持一个 CSV 文件。
• 匹配不区分大小写，并忽略非字母数字字符；查询前会对输入字符串进行清理。
• 如果同一个清理后的键对应多个定义，将以列表形式返回所有定义。