iflow-mcp_ondics-ckan-mcp-server

# CKAN MCP Server A Model Context Protocol (MCP) server for the CKAN API that enables browsing and managing CKAN data portals through MCP-compatible clients. ## What is this? This is an MCP server that provides access to CKAN (Comprehensive Knowledge Archive Network) APIs through the Model Context Protocol. It can be used with MCP-compatible clients like Claude Desktop, IDEs, or other AI applications to interact with CKAN data portals. ## Requirements - Python 3.13 or higher - pip (Python package installer) ## Installation 1. Install Python dependencies: ```bash pip install -r requirements.txt ``` ## Configuration Set the following environment variables: - `CKAN_URL`: The base URL of your CKAN portal (e.g. `https://demo.ckan.org`) - `CKAN_API_KEY`: (Optional) Your CKAN API key for write operations Example: ```bash export CKAN_URL="https://demo.ckan.org" export CKAN_API_KEY="your-api-key-here" ``` You can also copy `.env.example` to `.env` and set your configuration there. ## Usage ### Running the server directly ```bash python mcp_ckan_server.py ``` ### Using Docker ```bash # Build the image docker build -t ckan-mcp-server . # Run with environment variables docker run -e CKAN_URL="https://demo.ckan.org" -e CKAN_API_KEY="your-key" ckan-mcp-server ``` ### Using Docker Compose ```bash # Copy environment file and configure cp .env.example .env # Edit .env with your settings # Run the server docker-compose up ``` ## Available Tools The MCP server provides the following tools: ### Packages/Datasets - `ckan_package_list`: List all packages - `ckan_package_show`: Show details of a specific package - `ckan_package_search`: Search for packages ### Organizations - `ckan_organization_list`: List all organizations - `ckan_organization_show`: Show organization details ### DataStore - `ckan_datastore_search` Search DataStore Tables by Resource ### Groups and Tags - `ckan_group_list`: List all groups - `ckan_tag_list`: List all tags ### Resources - `ckan_r…