MCP-Server-for-Indonesian-Custom-Tarif
If you are the rightful owner of MCP-Server-for-Indonesian-Custom-Tarif and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This document provides an overview of a Model Context Protocol (MCP) server tailored for Indonesian customs tariff data and Hascode API integration.
MCP Server Example for Indonesian Customs Tariff & Hascode API
This repository provides an example implementation of a Model Context Protocol (MCP) server, customized for educational use in the context of Indonesian customs tariff data and Hascode API integration. The project demonstrates how to build a functional MCP server that connects to APIs such as Hascode to fetch tariff and HS code information for AI models.
What is MCP?
MCP (Model Context Protocol) is an open standard designed to provide structured context to Large Language Models (LLMs). You can think of MCP like a USB-C port for AI—offering a standardized way to plug models into various external data sources, such as customs tariff APIs, HS code lookups, or logistics databases.
Key Benefits
- Pre-built integrations for services like the Hascode API, which provides real-time HS code and duty rate information
- Flexibility to work across different LLM providers (OpenAI, Anthropic, etc.)
- A clean abstraction layer for securely accessing regulated data like import/export tariff structures
Architecture Overview
MCP uses a client-server architecture that supports multiple data access points:
- MCP Hosts: AI tools like Claude Desktop or enterprise assistants that request structured customs data
- MCP Clients: Protocol intermediaries that handle 1:1 communication with servers
- MCP Servers: Lightweight components that expose data and capabilities, such as fetching Indonesian customs tariffs via API
- Data Sources: Includes local files (e.g., PDF duty schedules) and remote APIs like Hascode or customs office databases
Core MCP Concepts
An MCP server typically exposes three types of capabilities:
- Resources: HS code datasets, tariff schedules, or API responses (e.g., duty rate for a specific product)
- Tools: API functions that an LLM can call to get updated customs information
- Prompts: Pre-configured templates (e.g., "What is the import duty for HS Code 8703.23.91.00 in Indonesia?")
System Requirements
- Python 3.10 or higher
- MCP SDK 1.2.0 or higher
uvpackage manager
Getting Started
Installing uv Package Manager
On MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Then restart your terminal to enable the uv command.
Project Setup
- Initialize your MCP project:
uv init mcp-server
cd mcp-server
uv venv
source .venv/bin/activate # Use .venv\Scripts\activate on Windows
uv add "mcp[cli]" httpx
- Create the main server file:
touch main.py
Example: Integrate with Hascode API
In main.py, you can define a resource to fetch tariff data using Hascode:
import httpx
from mcp import Resource
class HsCodeTariffResource(Resource):
def read(self, hs_code: str):
response = httpx.get(f"https://api.hascode.id/tariff?code={hs_code}")
return response.json()
Running the Server
Start the server:
uv run main.py
Connecting to Claude Desktop
- Install Claude Desktop
- Edit the config file at:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/YOUR/mcp-server",
"run",
"main.py"
]
}
}
}
- Restart Claude Desktop
Troubleshooting
If Claude Desktop fails to detect your server:
- Check the config file path and syntax
- Use the absolute path for all directories
- Ensure
uvis installed and working - Review Claude logs for connection issues
License
This project is licensed under the MIT License. See the file for more details.
