MCP 호환 클라이언트를 통해 CKAN 데이터 포털을 검색하고 관리 할 수있는 CKAN API의 모델 Context Protocol (MCP) 서버.

이것은 무엇입니까?

CKAN (Comprehensive Knowledge Archive Network) API에 액세스하는 MCP 서버입니다. Claude Desktop, IDE 또는 CKAN 데이터 포털과 상호 작용하는 기타 AI 애플리케이션과 같은 MCP 호환 클라이언트와 함께 사용할 수 있습니다.

요구 사항

• Python 3.13 이상
• pip (Python 패키지 설치자)

설치

1. Python 의존성 설치:

구성

다음 환경 변수를 설정:

• CKAN_URL: CKAN 포털의 기본 URL (예: https://demo.ckan.org)
• CKAN_API_KEY: (선택 사항) CKAN API 키 쓰기 작업

예:

.env.example]를 .env]로 복사하여 설정할 수 있습니다.

사용법

서버를 직접 실행

Docker 사용

Docker Compose 사용

도구

MCP 서버는 다음과 같은 도구를 제공합니다:

패키지/데이터셋

• ckan_package_list: 모든 패키지
• ckan_package_show: 특정 패키지의 세부 사항 보기
• [T7]]: 패키지 검색

조직

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:

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:

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

python mcp_ckan_server.py

Using Docker

# 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

# Copy environment file and configure
cp .env.example .env
# Edit .env with your settings

# Run the server
docker-compose up

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_resource_show: Show resource details

System

• ckan_site_read: Site information
• ckan_status_show: Status and version information

Examples

Search packages

{
  "tool": "ckan_package_search",
  "arguments": {
    "q": "climate data",
    "rows": 5,
    "sort": "score desc"
  }
}

Show organization

{
  "tool": "ckan_organization_show",
  "arguments": {
    "id": "sample-organization",
    "include_datasets": true
  }
}

List all tags

{
  "tool": "ckan_tag_list",
  "arguments": {}
}

Resources

The server also provides the following resources:

• ckan://api/docs: API documentation
• ckan://config: Server configuration

Using with MCP Clients

Claude Desktop

Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "ckan": {
      "command": "python",
      "args": ["/path/to/mcp_ckan_server.py"],
      "env": {
        "CKAN_URL": "https://demo.ckan.org",
        "CKAN_API_KEY": "your-api-key-here"