AparaviSoftware/dtc-mcp-server

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)

Quick Start Installation

For Users

The fastest way to get started is using npx:

First get your API-Key from our Development Portal here (you can watch this video for orientation).

1. Run the Server

   # For Unix/Linux/macOS - Set API keys in terminal
   export APARAVI_API_KEY=your_api_key_here
   
   # For Windows - Set API keys in Command Prompt
   set APARAVI_API_KEY=your_api_key_here
   
   # OR for Windows PowerShell
   $env:APARAVI_API_KEY="your_api_key_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 (Windsurf, Claude, Cursor) with this:

    {
      "mcpServers": {
        "aparavi": {
          "url": "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 Up Python Environment

    npx aparavi-mcp@latest
   

3. 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 file for details.