Servidor MCP de Aucterra

Este repositorio configura un servidor compatible con MCP para las API de comprensión de documentos de Aucterra utilizando el paquete aucterra-mcp .

Permite a los agentes de LLM interactuar con los servicios de extracción, clasificación, etc. de documentos de Aucterra mediante el Kit de desarrollo de agentes (ADK) de Google .

🔧 Configuración

Incluya este bloque en su configuración mcpServers (por ejemplo, config.json o mcp.yaml ):

{
  "mcpServers": {
    "aucterra": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/japisuru/aucterra-mcp",
        "aucterra-mcp"
      ],
      "env": {
        "AUCTERRA_API_KEY": "your_api_key_here"
      }
    }
  }
}

🔐 Variables de entorno requeridas

Related MCP server: A2A Client MCP Server

⚙️ Comportamiento de la herramienta

Esta herramienta MCP proporciona acceso estructurado a Aucterra:

• 📁 Clasificación de documentos

• 🗂️ Extracción de campos clave-valor (campos simples y de lista)

La herramienta acepta archivos pdf o image y devuelve una salida JSON estructurada.

✅ Integración de agentes (Google ADK)

Para utilizar esta herramienta dentro de su LlmAgent , configúrela de la siguiente manera:

from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset, StdioServerParameters

aucterra_tool = MCPToolset(
    connection_params=StdioServerParameters(
        command="pipx",
        args=[
            "run",
            "--spec",
            "git+https://github.com/japisuru/aucterra-mcp",
            "aucterra-mcp"
        ],
        env={"AUCTERRA_API_KEY": "your_api_key_here"}
    )
)

Agregue esta herramienta a su agente a través de tools=[aucterra_tool] .

📚 Casos de uso de ejemplo

User: Classify this document (/path/to/the/document/doc.pdf) into invoice or identity document.
User: Extract the following fields: NIC, Full Name, Date of Birth from this document (/path/to/the/document/doc.pdf) 
User: Extract Tax ID as 'Tax Identification Number' from this document (/path/to/the/document/doc.pdf).

El agente utilizará el servidor MCP de Aucterra para extraer campos y completar los valores faltantes (por ejemplo, utilizando el mismo valor para field_key y field_name si solo se proporciona uno).

📦 Dependencias

Asegúrese de que pipx esté instalado y disponible en su sistema.
Instalarlo mediante:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

🛠️ Problemas

Si encuentra problemas, asegúrese de que su clave API sea correcta y que la herramienta esté actualizada:

pipx upgrade aucterra-mcp

🔗 Proyectos relacionados

• Aucterra MCP

• Kit de desarrollo de Google

• Protocolo MCP