datagovma-mcp

MCP server for the Moroccan Open Data portal (data.gov.ma).

datagovma-mcp exposes curated MCP tools backed by CKAN Action API endpoints so AI clients can discover datasets, resources, organizations, and groups in a consistent typed shape.

What this project provides

• Streamable HTTP MCP server built with FastMCP.

• Typed and validated tool inputs/outputs.

• Centralized CKAN envelope validation (success checks, JSON checks, timeout handling).

• Test suite covering success and error paths.

• Docker image and Docker Compose setup.

Related MCP server: data-bs-mcp

Implemented MCP tools

Requirements

• Python >=3.11

• uv for dependency management

• Docker (optional, for containerized runs)

Quick start (local)

uv sync --frozen --group dev
cp .env.example .env
set -a && source .env && set +a
uv run datagovma-mcp

Default endpoint:

• MCP: http://127.0.0.1:8000/mcp

• Health: http://127.0.0.1:8000/healthz

Quick health check:

curl -fsS http://127.0.0.1:8000/healthz

Expected response:

• 200 OK with body ok.

Run with Docker

docker compose up --build

The service starts on port 8000 by default and exposes /mcp and /healthz.

Connect from LLM clients

Claude Desktop

After the server is running, edit:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Then add:

{
  "mcpServers": {
    "opengovma": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:8000/mcp"]
    }
  }
}

Claude Code

Add the server with Claude Code CLI:

claude mcp add --transport http opengovma http://127.0.0.1:8000/mcp

Codex (Desktop app and CLI)

Add the server with Codex CLI:

codex mcp add opengovma --url http://127.0.0.1:8000/mcp

VS Code (GitHub Copilot MCP)

Create .vscode/mcp.json in your workspace (or open your user MCP config via command palette) and add:

{
  "servers": {
    "opengovma": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Cursor

Add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "opengovma": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Configuration

Environment variables are loaded by your shell or container runtime.

Notes:

• MCP_RELOAD=true requires MCP_WORKERS=1.

• MCP_LOG_FORMAT=rich falls back to plain logs if Rich is unavailable.

Continuous integration

GitHub Actions workflow: .github/workflows/ci.yml

CI runs on pull requests and pushes to main/master and includes:

• dependency review (PR only)

• lint (ruff)

• format check (ruff format --check)

• type check (mypy)

• tests (pytest)

• package build (uv build)

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, checks, and PR guidance.

License

Licensed under the MIT License. See LICENSE.