🚀 eRegulations MCP Server

An MCP server that enables access to eRegulations API data. This server provides AI models with a structured and AI - friendly way to access eRegulations instances, making it easier to answer user questions about administrative procedures.

✨ Features

• Access eRegulations data through a standardized protocol.
• Query procedures, steps, requirements, and fees.
• Provide MCP prompt templates for LLM tools.
• Achieve a simple installation with standard input - output connections.

🚀 Quick Start

💻 Usage Examples

Basic Usage

The best way to run this server is by using the packaged Docker image published from the GitHub Container Registry (GHCR). This ensures environment consistency and isolation.

# 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 actual API base URL of your eRegulations instance (e.g., https://api-tanzania.tradeportal.org).

The server listens for MCP JSON requests on standard input and outputs responses to standard output.

Advanced Usage

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

{
  "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 replace the value of EREGULATIONS_API_URL in the env section.)

📦 Installation

Using Smithery

Alternatively, you can install and run this server via Smithery:

Visit https://smithery.ai/server/@unctad-ai/eregulations-mcp-server for installation commands.

Using npm Registry (Deprecated)

Running the server directly with npx is deprecated due to environment inconsistency issues.

~~```bash

Pull the latest package (optional)

npm install -g @unctad-ai/eregulations-mcp-server

Run the server, providing the target eRegulations API URL

EREGULATIONS_API_URL="https://your-eregulations-api.com" mcp-server

## 📚 Documentation
### Environment Variables
| Property | Details |
|----------|---------|
| `EREGULATIONS_API_URL` | The base URL of the eRegulations API to connect to. |

### Provided Tools
#### MCP Server
```bash
# Install dependencies
npm install @unctad-ai/eregulations-mcp-server

# Run the server, providing the target eRegulations API URL
EREGULATIONS_API_URL="https://your-eregulations-api.com" node index.js

Development Information

# Install dependencies
npm install

# Start the development server
npm start

# Write code in TypeScript
npm run dev

# Run tests
npm test

# Run client tests
npm run test-client

Please refer to the development documentation for detailed information.

Contribution Guidelines

Please refer to the Contribution Guidelines to learn how to contribute to the project.