Aucterra MCP サーバー
このリポジトリは、aucterra-mcpパッケージを使用して、Aucterra の Document Understanding API 用の MCP 互換サーバーを構成します。
これにより、LLM エージェントは、Google のエージェント開発キット (ADK)を使用して、Aucterra のドキュメント分類、抽出などのサービスと対話できるようになります。
🔧 構成
このブロックを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"
}
}
}
}🔐 必要な環境変数
変数 | 説明 |
| 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が 1 つしか指定されていない場合は、同じ値を使用します)。
📦 依存関係
pipxがシステムにインストールされ、利用可能であることを確認してください。
次の方法でインストールします:
python3 -m pip install --user pipx
python3 -m pipx ensurepath🛠️ 問題点
問題が発生した場合は、API キーが正しいこと、ツールが最新であることを確認してください。
pipx upgrade aucterra-mcp