Suppr

Provides an MCP endpoint for translating documents and performing literature searches using an API key-based authentication.

javascript

127

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wilddatax-suppr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "suppr-mcp"
      ],
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

You can run the Suppr MCP server as a local, self-contained MCP endpoint that your client can invoke to translate documents and search PubMed-like literature. It exposes a ready-to-use, environment-based API key workflow and simple, reusable MCP configurations so your client can start translating or searching right away.

How to use

Set up your MCP client to talk to the Suppr MCP server by providing your API key and choosing a runtime configuration. You can run the server via npx for quick testing or install a local command for ongoing use. Use the provided MCP configurations to connect the client to the server, and then issue translation tasks or literature searches from your client as you normally would with an MCP service.

How to install

Prerequisites you need before starting:

Node.js version 18.0.0 or newer
npm or npx installed on your system

Install the Suppr MCP client globally for quick usage or run it directly with npx for a one-off start.

npm install -g suppr-mcp

or use npx without installation:

npx suppr-mcp

Configure and run the MCP server

You must provide your API key so the server can authenticate requests. Set the API key in your environment, then configure the MCP client to use one of the supported startup options.

export SUPPR_API_KEY=your_api_key_here

Option A: Use npx to run the MCP server in place (quick start) with explicit argument passing.

{
  "mcpServers": {
    "suppr": {
      "command": "npx",
      "args": ["-y", "suppr-mcp"],
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Option B: Run a local MCP command for persistent use

If you prefer a dedicated local command, you can run the server with a direct CLI entry that uses your API key.

{
  "mcpServers": {
    "suppr": {
      "command": "suppr-mcp",
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

create_translation

Create a document translation task by providing either a file path or a file URL, target language, and optional source language and math formula optimization for PDFs.

get_translation

Retrieve details and status for a translation task using its task_id.

list_translations

List translation tasks with pagination support (offset and limit).

search_documents

AI-powered semantic search for documents with configurable return fields and auto-select option.