@lingpie/mcp-server

MCP (Model Context Protocol) server that exposes LingPie integration tools for Cursor and other AI agents.

Uses the same lingpie.yaml config as @lingpie/cli.

Requires Node.js ≥ 20 and LINGPIE_API_KEY (lp_…) in the MCP server environment.

Install / run

No global install required — Cursor and other hosts typically invoke via npx:

npx -y @lingpie/mcp-server

Cursor configuration

Add to your app repo as .cursor/mcp.json (recommended) or globally at ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lingpie": {
      "command": "npx",
      "args": ["-y", "@lingpie/mcp-server"],
      "env": {
        "LINGPIE_API_KEY": "lp_..."
      }
    }
  }
}

Only LINGPIE_API_KEY is required in env. Tools resolve lingpie.yaml at call time via the workspaceRoot argument — pass the absolute path to your project directory. If lingpie.yaml is missing, tools return config_not_found and suggest calling lingpie_init.

Tools

Mirrors the CLI — each tool maps to a lingpie subcommand:

| Tool | CLI equivalent | |------|----------------| | lingpie_init | lingpie init — create lingpie.yaml | | lingpie_pull | lingpie pull — export translations to local files | | lingpie_push | lingpie push — import local files | | lingpie_keys_list | lingpie keys list — search/list keys (paginated) | | lingpie_languages_list | lingpie languages list | | lingpie_languages_add | lingpie languages add | | lingpie_languages_edit | lingpie languages edit | | lingpie_languages_remove | lingpie languages remove |

Every tool accepts workspaceRoot when the MCP process cwd is not your app repo (typical in Cursor).

License

MIT — see LICENSE.