aucterra-mcp
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"aucterra": {
"args": [
"run",
"--spec",
"git+https://github.com/japisuru/aucterra-mcp",
"aucterra-mcp"
],
"command": "pipx",
"env": {
"AUCTERRA_API_KEY": "your_api_key_here"
}
}
}
}服务介绍
Aucterra MCP Server
This repository configures an MCP-compatible server for Aucterra's Document Understanding APIs using the aucterra-mcp package.
It enables LLM agents to interact with Aucterra's document classification, extraction, etc. services using Google's Agent Development Kit (ADK).
Configuration
Include this block in your mcpServers configuration (e.g., config.json or 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"
}
}
}
}
Required Environment Variables
| Variable | Description |
|---|---|
AUCTERRA_API_KEY |
Your API key for accessing Aucterra's services |
Tool Behavior
This MCP tool provides structured access to Aucterra's:
- Document Classification
- Key-Value Field Extraction (Simple + List fields)
The tool accepts pdf or image files and returns structured JSON output.
Agent Integration (Google ADK)
To use this tool within your LlmAgent, configure it as follows:
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"}
)
)
Add this tool to your agent via tools=[aucterra_tool].
Example Use Cases
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).
The agent will use the Aucterra MCP server to extract fields, filling in missing values (e.g., using the same value for field_key and field_name if only one is provided).
Dependencies
Ensure pipx is installed and available on your system.
Install it via:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
Issues
If you encounter issues, ensure your API key is correct and the tool is up to date:
pipx upgrade aucterra-mcp
