Сервер MCP Aucterra

Этот репозиторий настраивает сервер, совместимый с MCP, для API-интерфейсов Aucterra Document Understanding с использованием пакета aucterra-mcp .

Он позволяет агентам LLM взаимодействовать со службами классификации, извлечения и т. д. документов Aucterra с помощью комплекта разработки агентов Google (ADK) .

🔧 Конфигурация

Включите этот блок в конфигурацию mcpServers (например, config.json или 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"
      }
    }
  }
}

🔐 Необходимые переменные среды

Related MCP server: A2A Client MCP Server

⚙️ Поведение инструмента

Этот инструмент MCP обеспечивает структурированный доступ к следующим данным Aucterra:

• 📁 Классификация документов

• 🗂️ Извлечение поля «ключ-значение» (простое + поля списка)

Инструмент принимает файлы pdf или image и возвращает структурированный вывод в формате JSON.

✅ Интеграция агента (Google ADK)

Чтобы использовать этот инструмент в вашем LlmAgent , настройте его следующим образом:

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

Добавьте этот инструмент к своему агенту через tools=[aucterra_tool] .

📚 Примеры использования

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

Агент будет использовать сервер Aucterra MCP для извлечения полей, заполняя отсутствующие значения (например, используя одно и то же значение для field_key и field_name , если указано только одно).

📦 Зависимости

Убедитесь, что pipx установлен и доступен в вашей системе.
Установите его через:

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

🛠️ Проблемы

Если у вас возникли проблемы, убедитесь, что ваш ключ API правильный и инструмент обновлен:

pipx upgrade aucterra-mcp

🔗 Связанные проекты

• Оустерра MCP

• Google ADK

• Протокол МСР