ComIDP

ComIDP MCP Server is a lightweight Python-based MCP server that exposes the Intelligent Document Extraction capabilities of ComIDP. It listens for prompts and returns structured plain-text results extracted from unstructured documents such as PDFs. You can configure the server to run via uv and point Claude Desktop (or other MCP-enabled clients) to the comidp_tools.py entry point, enabling automated data extraction workflows. The server is designed to work with an API key (IDPKEY) and can process PDFs in batch, returning a mapping from input files to extracted data in a readable text format suitable for downstream processing or archival.

Prerequisites:

• Python 3.10 or higher
• pip (Python package installer)
• uv (the MCP runner for Python)

Install and run:

1. Clone or download the ComIDP MCP repository to your local machine.
2. Install uv globally or in a virtual environment:
   • python -m pip install uv
3. Navigate to the project folder and set up a Python virtual environment:
   • Windows: cd comidp-mcp\src python -m venv .venv .venv\Scripts\activate
   • Linux / macOS: cd comidp-mcp/src python -m venv .venv source .venv/bin/activate
4. Install required Python packages:
   • pip install -r requirements.txt
5. Prepare the configuration for your MCP client (e.g., Claude Desktop) as shown in the mcp_config example below and ensure you provide your IDPKEY:
   • IDPKEY is required for data extraction. Store it securely and reference it in the env configuration.
6. Start the MCP server via uv using the configuration described in mcp_config (adjust PATH/TO accordingly) and ensure the server is reachable by your MCP client.

Notes:

• The paths PATH/TO/comidp-mcp/src/virtual environment python and PATH/TO/comidp-mcp/src/comidp_tools.py must be replaced with absolute paths to your Python executable inside the virtual environment and the ComIDP tool entry script, respectively.
• Ensure the IDPKEY is valid and has permissions for data extraction.
• If you are integrating with Claude Desktop, follow the Claude Desktop configuration steps to register the comidp-mcp MCP server.

Tips and caveats:

• Use absolute paths in the UV command configuration.
• Keep the IDPKEY secure; do not commit it to public repos.
• If you upgrade Python or dependencies, re-create the virtual environment and re-install requirements.
• The MCP server returns structured plain-text results; you may want to post-process or format the output for downstream systems.
• For batch processing, you can provide a list of PDFs or a folder path and enable recursive scanning if supported by your integration.
• If you encounter connectivity issues, verify that the uv runner is correctly invoking comidp_tools.py and that the environment variables are accessible to the process.