cubeparser-mcp

# CubeParser MCP Server A Model Context Protocol (MCP) server that provides access to CubeParser document extraction API. This server can be run directly using `uvx` with absolute paths for easy deployment and sharing. ## 🚀 Quick Start with uvx ### For End Users (Running the Server) If someone has shared this project with you, you can run it directly using uvx with the absolute path: ```bash # Replace with the actual absolute path provided to you uvx --from "C:\path\to\cubeparser_mcp" cubeparser-mcp ``` **Example:** ```bash uvx --from "C:\Users\Remy\sensedeal\code\projects\work\CITICS2025\zhangkai\cubeparser_mcp" cubeparser-mcp ``` ### For Developers (Setting Up for Sharing) 1. **Clone and Setup**: ```bash git clone <repository-url> cd cubeparser_mcp uv sync ``` 2. **Run Setup Script**: ```bash uv run python setup_uvx.py ``` This creates: - `mcp_config.json` - MCP client configuration with absolute paths - `.env.template` - Environment variables template - `run_cubeparser_mcp.bat` - Quick run script for Windows 3. **Configure Environment**: ```bash cp .env.template .env # Edit .env with your CubeParser credentials ``` ## 📋 Features This MCP server provides three main tools: 1. **get_templates** - Retrieve available extraction templates from CubeParser 2. **create_task** - Upload files and create extraction tasks with specified templates 3. **download_results** - Get extraction results from completed tasks ## 🛠️ Installation Methods ### Method 1: Direct uvx Usage (Recommended for Sharing) ```bash # Run from absolute path (replace with actual path) uvx --from "/absolute/path/to/cubeparser_mcp" cubeparser-mcp # Or on Windows uvx --from "C:\absolute\path\to\cubeparser_mcp" cubeparser-mcp ``` ### Method 2: Local Development ```bash # Install dependencies uv sync # Run directly uv run python main.py # Or use the generated batch file .\run_cubeparser_mcp.bat # Windows ./run_cubeparser_mcp.sh # Linux/Mac ``` ## ⚙️ Configuration ### Environment…