Aparavi MCP Server

An MCP (Model Context Protocol) server that integrates with Aparavi's document processing capabilities. This server allows Language Models to process documents through Aparavi's API and receive cleaned text output.

Features

• 📄 Document processing via Aparavi API
• 🧹 Clean text extraction without metadata
• 🔌 MCP-compliant interface
• ⚙️ Environment-based configuration
• 🚀 Async processing support
• 📦 Easy installation via NPX
• 🔍 OCR capabilities for system diagrams
• 🐍 Python-based with Node.js wrapper

Table of Contents

• Prerequisites
• Quick Start
• Installation
  • For Users
  • For Developers
• Configuration
• Usage
  • Running as a User
  • Running for Development
• API Documentation
• Testing
• Project Structure
• Contributing

Prerequisites

• Python 3.8 or higher
• Node.js 14 or higher
• Git (for development setup)

Installation

For Users

There are two ways to install the MCP server as a user:

1. Run the Server

     
   # Set API keys in terminal and choose which Aparavi server you want to use
   # For US users: https://eaas.aparavi.com
   # For EU users: https://eaas.aparavi.eu
   
   # For Unix/Linux/macOS
   export APARAVI_API_KEY=your_api_key_here
   export APARAVI_API_URL=your_url_here
   
   # For Windows - Set API keys in Command Prompt
   set APARAVI_API_KEY=your_api_key_here
   set APARAVI_API_URL="your_url_here"
   
   # OR for Windows PowerShell
   $env:APARAVI_API_KEY="your_api_key_here"
   $env:APARAVI_API_URL="your_url_here"
   
   # Run the server (same command for all platforms)
   npx aparavi-mcp@latest

2. Add Server to your Client Update your MCP_config.json file in the client with this:

    {
      "mcpServers": {
        "aparavi": {
          "serverUrl": "http://localhost:8000/mcp"
        }
      }
    }
    

For Developers

For local development and testing:

1. Clone the Repository

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

2. Set Environment Variables

   # For US users: https://eaas.aparavi.com
   # For EU users: https://eaas.aparavi.eu
   
   # For Unix/Linux/macOS
   export APARAVI_API_KEY=your_api_key_here
   export APARAVI_API_URL=your_url_here
   
   # For Windows - Set API keys in Command Prompt
   set APARAVI_API_KEY=your_api_key_here
   set APARAVI_API_URL="your_url_here"
   
   # OR for Windows PowerShell
   $env:APARAVI_API_KEY="your_api_key_here"
   $env:APARAVI_API_URL="your_url_here"

3. Set Up Python Environment

    npx aparavi-mcp@latest

4. Running Tests First, ensure your server is running (from step 1). Then you can run and configure tests:

   # Run the test tool
   python tests/test_tool.py

   To test different tools or files, open tests/test_tool.py and modify the main() function:

   def main():
       # Change the file path to test different documents
       file_path = "tests/testdata/test_document.txt"
       # Or try other test files:
       # file_path = "tests/testdata/SDD_RoadTrip.pdf"
       # file_path = "tests/testdata/system_diagram.jpeg"
   
       # Change the tool name to test different tools
       tool_name = "document_processor"
       # Available tools:
       # - "Aparavi_Document_Processor" (for text documents)
       # - "Advanced_OCR_Parser" (for diagrams/images)
   
       run_tool_test(file_path, tool_name)

Configuration

Required Environment Variables

• APARAVI_API_KEY: Your Aparavi API key (required)

Project Structure

aparavi-mcp/
├── bin/                    # Executable scripts
│   ├── index.js           # Node.js entry point
│   └── setup.sh           # Python environment setup
|__ prompts/               #Preconfigured prompts
├── tools/                 # MCP tool implementations
├── resources/             # Configuration and resources
├── tests/                 # Test files
├── mcp-server.py         # Main Python server
├── requirements.txt      # Python dependencies
└── package.json         # Node.js package config

License

This project is licensed under the MIT License - see the LICENSE file for details.