Upstage MCP Server

by PritamPatil2603

3 176 downloads Not rated yet MIT

GitHub

Other

About

A Model Context Protocol server for parsing documents using Upstage AI's document digitization API.

Details

License: MIT

Explore

- Document Digitization: Extract structured content from documents while preserving layout.
- Information Extraction: Retrieve specific data points using intelligent, customizable schemas.
- Multi-format Support: Handles JPEG, PNG, BMP, PDF, TIFF, HEIC, DOCX, PPTX, and XLSX.
- Claude Desktop Integration: Effortlessly connect with Claude and other MCP clients.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Upstage MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

From the repository

Before using this server, ensure you have the following:

1. Upstage API Key: Obtain your API key from Upstage API.
2. Python 3.10+: The server requires Python version 3.10 or higher.
3. The MCP server relies upon Astral UV to run, please install

This guide provides step-by-step instructions to set up and configure the upstage-mcp-server

For integration with Claude Desktop, add the following content to your claude_desktop_config.json:

- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Follow these steps to set up and run the project locally:

pip install uv uv venv

uv pip install -e .

1. Download Claude Desktop:
Download Claude Desktop

2. Open and Edit Configuration:
- Navigate to Claude → Settings → Developer → Edit Config.
- Edit the claude_desktop_config.json file with the following configurations:

For Windows:

   {

     "mcpServers": {

       "upstage-mcp-server": {

         "command": "uv",

         "args": [

           "run",

           "--directory",

           "C:\\path\\to\\cloned\\upstage-mcp-server",

           "python",

           "-m",

           "upstage_mcp.server"

         ],

         "env": {

           "UPSTAGE_API_KEY": "your_api_key_here"

         }

       }

     }

   }

Replace C:\\path\\to\\cloned\\upstage-mcp-server with your actual repository path.

For macOS/Linux:

   {

     "mcpServers": {

       "upstage-mcp-server": {

         "command": "/Users/username/.local/bin/uv",

         "args": [

           "run",

           "--directory",

           "/path/to/cloned/upstage-mcp-server",

           "python",

           "-m",

           "upstage_mcp.server"

         ],

         "env": {

           "UPSTAGE_API_KEY": "your_api_key_here"

         }

       }

     }

   }

Replace:
- /Users/username/.local/bin/uv with the output of which uv.
- /path/to/cloned/upstage-mcp-server with the absolute path to your local clone.

> Tip for macOS/Linux users: If connection issues occur, using the full path to your uv executable can improve reliability.

After configuring, restart Claude Desktop.

The server exposes two primary tools for AI models:

1. Document Parsing (parse_document):
- Description: Processes documents and extracts content while preserving structure.
- Parameter:
file_path – the path to the document to be processed.
- Example Query:
"Can you parse the document at C:\Users\username\Documents\contract.pdf and provide a summary?"

2. Information Extraction (extract_information):
- Description: Extracts structured information from documents based on predefined or auto-generated schemas.
- Parameters:
file_path – the document file path;
schema_path (optional) – a JSON file with an extraction schema;
auto_generate_schema (default true) – whether to auto-generate a schema.
- Example Query:
"Extract the invoice number, date, and total from C:\Users\username\Documents\invoice.pdf."

Below is the revised troubleshooting section formatted as requested. You can copy and paste the following Markdown directly into your README:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "upstage mcp server": {
            "upstage-mcp-server": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "upstage-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "upstage-mcp-server": {
        "command": "uv",
        "args": [
            "pip",
            "install",
            "upstage-mcp-server"
        ]
    }
}

> A Model Context Protocol (MCP) server for Upstage AI's document digitization and information extraction capabilities

Overview

The Upstage MCP Server provides a robust bridge between AI assistants and Upstage AI’s powerful document processing APIs. This server enables AI models—such as Claude—to effortlessly extract and structure content from various document types including PDFs, images, and Office files. The package supports multiple formats and comes with seamless integration options for Claude Desktop.

Key Features

Prerequisites

Before using this server, ensure you have the following:

Installation & Configuration

This guide provides step-by-step instructions to set up and configure the upstage-mcp-server

Using `uv` (Recommended)

No additional installation is required when using uvx as it handles execution. However, if you prefer to install the package directly:

uv pip install upstage-mcp-server

Configure Claude Desktop

For integration with Claude Desktop, add the following content to your claude_desktop_config.json:

Configuration Location

- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Using uvx Command (Recommended)

{
  "mcpServers": {
    "upstage-mcp-server": {
      "command": "uvx",
      "args": ["upstage-mcp-server"],
      "env": {
        "UPSTAGE_API_KEY": "<your-api-key>"
      }
    }
  }
}

If uvx is not available globally, you may encounter a Server disconnected error. To resolve this, run which uvx to find its full path, and replace "command": "uvx" above with the returned path.

After adding the configuration, restart Claude Desktop to apply the changes.

Output Directories

Processing results are stored in your home directory under:

- Document Parsing Results:
~/.upstage-mcp-server/outputs/document_parsing/
- Information Extraction Results:
~/.upstage-mcp-server/outputs/information_extraction/
- Generated Schemas:
~/.upstage-mcp-server/outputs/information_extraction/schemas/

Local/Development Setup

Follow these steps to set up and run the project locally:

Step 1: Clone the Repository

git clone https://github.com/PritamPatil2603/upstage-mcp-server.git
cd upstage-mcp-server

Step 2: Set Up the Python Environment

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Overview

Key Features

Prerequisites

Installation & Configuration

Using uv (Recommended)

Configure Claude Desktop

Configuration Location

Using uvx Command (Recommended)

After adding the configuration, restart Claude Desktop to apply the changes.

Output Directories

Local/Development Setup

Step 1: Clone the Repository

Step 2: Set Up the Python Environment

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Using `uv` (Recommended)