Aucterra MCP-Server

Dieses Repository konfiguriert mithilfe des Pakets aucterra-mcp einen MCP-kompatiblen Server für die Document Understanding APIs von Aucterra.

Es ermöglicht LLM-Agenten, mithilfe des Agent Development Kit (ADK) von Google mit den Diensten zur Dokumentklassifizierung, -extraktion usw. von Aucterra zu interagieren.

🔧 Konfiguration

Fügen Sie diesen Block in Ihre mcpServers -Konfiguration ein (z. B. config.json oder 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"
      }
    }
  }
}

🔐 Erforderliche Umgebungsvariablen

Related MCP server: A2A Client MCP Server

⚙️ Werkzeugverhalten

Dieses MCP-Tool bietet strukturierten Zugriff auf Aucterra:

• 📁 Dokumentenklassifizierung

• 🗂️ Schlüssel-Wert-Feldextraktion (einfache + Listenfelder)

Das Tool akzeptiert pdf oder image und gibt strukturierte JSON-Ausgabe zurück.

✅ Agentenintegration (Google ADK)

Um dieses Tool in Ihrem LlmAgent zu verwenden, konfigurieren Sie es wie folgt:

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"}
    )
)

Fügen Sie dieses Tool über tools=[aucterra_tool] zu Ihrem Agenten hinzu.

📚 Beispiel-Anwendungsfälle

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).

Der Agent verwendet den Aucterra MCP-Server, um Felder zu extrahieren und fehlende Werte auszufüllen (z. B. indem er denselben Wert für field_key und field_name verwendet, wenn nur einer angegeben ist).

📦 Abhängigkeiten

Stellen Sie sicher, dass pipx auf Ihrem System installiert und verfügbar ist.
Installieren Sie es über:

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

🛠️ Probleme

Wenn Probleme auftreten, stellen Sie sicher, dass Ihr API-Schlüssel korrekt und das Tool auf dem neuesten Stand ist:

pipx upgrade aucterra-mcp

🔗 Ähnliche Projekte

• Aucterra MCP

• Google ADK

• MCP-Protokoll