Installation #

The server is part of the metafrasi Python package and runs over stdio, so your MCP client launches it — you never run it by hand.

Requirements #

• Python ≥ 3.10
• A Microbooks account and a personal access token

Install the package #

pip install "metafrasi[mcp]"

This installs the metafrasi-mcp executable that MCP clients invoke.

Claude Desktop #

Open Settings → Developer → Edit Config and add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "microbooks": {
      "command": "metafrasi-mcp",
      "env": {
        "MICROBOOKS_API_URL": "https://api.microbooks.io",
        "MICROBOOKS_TOKEN": "<personal access token>"
      }
    }
  }
}

One-click setup. Signed-in users can generate this configuration — token included — at Dashboard → Developers → Connect Claude on microbooks.io.

Restart Claude Desktop; the Microbooks tools appear in the tools menu.

Other MCP clients #

Any client that supports stdio servers works the same way: run metafrasi-mcp with the environment variables described in Configuration.