Aucterra MCP 서버
이 저장소는 aucterra-mcp 패키지를 사용하여 Aucterra의 문서 이해 API에 대한 MCP 호환 서버를 구성합니다.
Google의 에이전트 개발 키트(ADK)를 사용하여 LLM 에이전트가 Aucterra의 문서 분류, 추출 등의 서비스와 상호 작용할 수 있도록 합니다.
🔧 구성
mcpServers 구성에 이 블록을 포함합니다(예: config.json 또는 mcp.yaml ):
지엑스피1
🔐 필수 환경 변수
변하기 쉬운 | 설명 |
| Aucterra 서비스에 액세스하기 위한 API 키 |
Related MCP server: MCP LLMS-TXT Documentation 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