What is Datagov Mcp

The DataGov Israel MCP Server is a project designed to interact seamlessly with the Israeli Government Public API found at data.gov.il. It allows users to access, search, and manage public datasets and resources made available by the government.

Use cases

This server can be used by developers and data analysts who need to retrieve and manipulate government datasets. It is beneficial for applications that require public data integrations, such as research projects, data visualizations, and application development that leverages government information.

How to use

To use the server, clone the repository, install dependencies using the ‘uv’ package manager, and set up a virtual environment. You can then run the server locally, install it in Claude Desktop, or test it with the MCP Inspector. Additionally, if you’re facing port issues, utilize the nano-dev-utils to free up busy ports.

Key features

Key features of the DataGov Israel MCP Server include functionalities to show server status, list licenses and organizations, search for packages and resources, fetch data from the public API, and conduct datastore searches with various filters. These features provide robust capabilities for data exploration and management.

Where to use

This server can be used in development environments where there’s a need for interaction with the Israeli government’s data repository. It’s particularly applicable for data-driven applications, research projects, and any sector that relies on accessing and utilizing public datasets for analysis or integration into larger systems.

DataGov Israel MCP Server

Easily interact with the Israeli Government Public API (data.gov.il) using this project.

Quick Start

Requirements

uv

This project uses the uv package manager, a drop-in replacement to pip.

Installation

1. Clone the repository:

   git clone <repository-url>
   cd datagov-mcp
   

2. Install dependencies (for windows users - refrain from running this script in folders watched by onedrive):

   uv venv
   .venv\Scripts\activate  # source .venv/bin/activate for MacOS / Linux
   uv pip install -r pyproject.toml
   uv lock # update the project's lockfile
   

Usage

You can install this server in Claude Desktop and interact with it right away by running:

fastmcp install server.py

Alternatively, you can test it with the MCP Inspector:

fastmcp dev server.py

If client / server ports are busy, you can easily free them using nano-dev-utils:

uv pip install nano-dev-utils

in terminal type ‘python’, and then run the following code:

from nano_dev_utils import release_ports 
pr = release_ports.PortsRelease()
pr.release_all()

type exit() to get back to terminal. Alternatively run the above code as a script.

Available Tools

• status_show - Display the current status of the server
• license_list - List all available licenses
• package_list - List all available packages
• package_search - Search for packages with various filters
  • Required arguments:
    • q (string): Query string to search for
    • fq (string): Filter query
    • sort (string): Sorting order
    • rows (int): Number of rows to return
    • start (int): Starting index
    • include_private (bool): Include private packages
• package_show - Show details of a specific package
  • Required arguments:
    • id (string): ID of the package
• organization_list - List all organizations
• organization_show - Show details of a specific organization
  • Required arguments:
    • id (string): ID of the organization
• resource_search - Search for resources with various filters
  • Required arguments:
    • query (string): Query string to search for
    • order_by (string): Order by field
    • offset (int): Offset for pagination
    • limit (int): Limit for pagination
• datastore_search - Search the datastore with various filters
  • Required arguments:
    • resource_id (string): ID of the resource
    • q (string): Query string to search for
    • distinct (bool): Return distinct results
    • plain (bool): Return plain results
    • limit (int): Limit for pagination
    • offset (int): Offset for pagination
    • fields (string): Fields to include in the result
    • sort (string): Sorting order
    • include_total (bool): Include total count
    • records_format (string): Format of the records
• fetch_data - Fetch data from public API based on a dataset name query
  • Required arguments:
    • dataset_name (string): Name of the dataset
    • limit (int): Number of records to fetch
    • offset (int): Offset for pagination

Contributing

We welcome contributions to help improve the DataGov Israel MCP server. Whether you want to add new tools, enhance existing functionality, or improve documentation, your input is valuable.

For examples of other MCP servers and implementation patterns, see the Model Context Protocol servers repository.

License

This project is licensed under the MIT License. See the LICENSE file for details.