zjg678
# **Suppr MCP - README.md** ```markdown # Suppr MCP <div align="center"> [](cursor://anysphere.cursor-deeplink/mcp/install?name=suppr&config=ewogICJjb21tYW5kIjogIm5weCIsCiAgImFyZ3MiOiBbIi15IiwgInN1cHByLW1jcCJdLAogICJlbnYiOiB7CiAgICAiU1VQUFJfQVBJX0tFWSI6ICIiCiAgfQp9) [](https://www.npmjs.com/package/suppr-mcp) [](LICENSE) AI-powered document translation and academic literature search service for MCP-compatible clients. [Features](#features) • [Quick Start](#quick-start) • [Installation](#installation) • [Tools](#tools) • [Support](#support) </div> --- ## Overview **Suppr MCP** is a Model Context Protocol (MCP) server that provides professional document translation and academic literature search capabilities. Built by the [WildData](https://wilddata.cn) team, it enables AI assistants to translate documents across 11 languages and search PubMed literature databases seamlessly. ## Features ### 📄 **Intelligent Document Translation** - **Multi-format support**: PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB - **11 languages**: English, Chinese, Japanese, Korean, French, German, Spanish, Russian, Arabic, Portuguese, Italian - **Mathematical formula optimization**: Special handling for academic papers with complex equations - **Batch processing**: Asynchronous task queue for multiple documents - **Translation history**: Track and manage all translation tasks ### 🔍 **Academic Literature Search** - **AI-driven search**: Semantic understanding for precise literature discovery - **PubMed integration**: Direct access to biomedical research database - **Rich metadata**: Returns title, abstract, authors, DOI, PMID, publication info - **Smart filtering**: Auto-select most relevant results --- ## Quick Start ### One-Click Install (Cursor) Click the button below to install Suppr MCP in Cursor: [](cursor://anysphere.cursor-deeplink/mcp/install?name=suppr&config=ewogICJjb21tYW5kIjogIm5weCIsCiAgImFyZ3MiOiBbIi15IiwgInN1cHByLW1jcCJdLAogICJlbnYiOiB7CiAgICAiU1VQUFJfQVBJX0tFWSI6ICIiCiAgfQp9) After installation: 1. Get your API key from [https://suppr.wilddata.cn/api-keys](https://suppr.wilddata.cn/api-keys) 2. Open Cursor Settings → **MCP** → Find **"suppr"** → Add your API key to `SUPPR_API_KEY` --- ## Installation ### Prerequisites - Node.js >= 18.0.0 - A Suppr API key (get one at [https://suppr.wilddata.cn/api-keys](https://suppr.wilddata.cn/api-keys)) ### Method 1: NPX (Recommended) Add to your MCP client configuration: ```json { "mcpServers": { "suppr": { "command": "npx", "args": ["-y", "suppr-mcp"], "env": { "SUPPR_API_KEY": "your_api_key_here" } } } } ``` ### Method 2: Global Installation ```bash npm install -g suppr-mcp ``` Configuration: ```json { "mcpServers": { "suppr": { "command": "suppr-mcp", "env": { "SUPPR_API_KEY": "your_api_key_here" } } } } ``` ### Method 3: Claude Desktop For macOS, edit `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "suppr": { "command": "npx", "args": ["-y", "suppr-mcp"], "env": { "SUPPR_API_KEY": "your_api_key_here" } } } } ``` For Windows, edit `%APPDATA%\Claude\claude_desktop_config.json` with the same configuration. --- ## Tools Suppr MCP provides 4 powerful tools: ### 1. `create_translation` Create a document translation task. **Parameters:** - `file_path` (optional): Local file path - `file_url` (optional): Remote file URL - `to_lang` (required): Target language code (e.g., `"en"`, `"zh"`, `"ja"`) - `from_lang` (optional): Source language code (default: `"auto"` for auto-detection) - `optimize_math_formula` (optional): Optimize mathematical formulas (boolean) **Example:** ```json { "file_url": "https://example.com/research-paper.pdf", "to_lang": "en", "from_lang": "