Eregulations MCP Server

🚀 eRegulations MCP Server

An implementation of the Model Context Protocol (MCP) server for accessing eRegulations API data. This server provides a structured, AI-friendly interface for AI models, making it easier to answer users' questions about administrative procedures.

✨ Features

• Access eRegulations data through a standardized protocol.
• Query procedures, steps, requirements, and fees.
• Provide MCP prompt templates to guide the use of LLM tools.
• Achieve a simple installation with a standard I/O connection.

🚀 Quick Start

💻 Usage Examples

Basic Usage

The best way to run the server is by using the Docker image published from the GitHub Container Registry (GHCR). This ensures a consistent and isolated environment.

# Pull the latest image (optional)
docker pull ghcr.io/unctad-ai/eregulations-mcp-server:latest

# Run the server, providing the target eRegulations API URL
export EREGULATIONS_API_URL="https://your-eregulations-api.com"
docker run -i --rm -e EREGULATIONS_API_URL ghcr.io/unctad-ai/eregulations-mcp-server

Replace https://your-eregulations-api.com with the base URL of the actual eRegulations instance you want to connect to (e.g., https://api-tanzania.tradeportal.org).

The server listens for MCP JSON requests on standard input and sends responses via standard output.

Advanced Usage

The following is an example showing how to configure a client (such as Claude) to use this server in Docker:

{
  "mcpServers": {
    "eregulations": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EREGULATIONS_API_URL",
        "ghcr.io/unctad-ai/eregulations-mcp-server:latest"
      ],
      "env": {
        "EREGULATIONS_API_URL": "https://your-eregulations-api.com"
      }
    }
  }
}

(Remember to also replace the value of EREGULATIONS_API_URL in the env section.)

📦 Installation via Smithery

Alternatively, you can install and run the server through Smithery:

Visit https://smithery.ai/server/@unctad-ai/eregulations-mcp-server for more information.

🔧 Technical Details

Environment Variable Configuration

export EREGULATIONS_API_URL="your-eregulations-api.com"

Parameters:

• EREGULATIONS_API_URL: The base URL of the eRegulations API to connect to.

Tools

• eregulations-mcp-server: Used to start the MCP server, supporting the following functions:
  • Query procedures.
  • Get step information.
  • Obtain requirement details.
  • Query fee data.
  • Handle other related requests.

Prompt Templates

Prompt templates provide users with an easy way to configure and run the MCP server. Here are the steps to use prompt templates:

1. Download and install the required tools.
2. Configure environment variables to ensure the server can connect to the target eRegulations API.
3. Start the server and test its functionality.

Development

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Run client tests
npm run test-client

This repository provides complete source code and documentation, facilitating developers to conduct secondary development and custom configuration.