CKAN MCP Server

CKAN MCP 服务

一个用于 CKAN API 的模型上下文协议（MCP）服务，可通过兼容 MCP 的客户端浏览和管理 CKAN 数据门户。

这是什么？

这是一个通过模型上下文协议提供 CKAN（综合知识档案网络）API 访问功能的 MCP 服务。你可以使用 Claude Desktop、IDE 或其他 AI 应用等兼容 MCP 的客户端与 CKAN 数据门户交互。

要求

• Python 3.13 或更高版本
• pip（Python 包安装程序）

安装

1. 安装 Python 依赖项：

pip install -r requirements.txt

配置

设置以下环境变量：

• CKAN_URL：CKAN 门户的基础 URL（例如 https://demo.ckan.org）
• CKAN_API_KEY：（可选）用于写入操作的 CKAN API 密钥

示例：

export CKAN_URL="https://demo.ckan.org"
export CKAN_API_KEY="your-api-key-here"

你也可以将 .env.example 复制为 .env，并在那里设置配置。

使用方法

直接运行服务

python mcp_ckan_server.py

使用 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

使用 Docker Compose

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

# Run the server
docker-compose up

工具

该 MCP 服务提供以下工具：

包/数据集

• ckan_package_list：列出所有包
• ckan_package_show：显示特定包的详细信息
• ckan_package_search：搜索包

组织

• ckan_organization_list：列出所有组织
• ckan_organization_show：显示组织详细信息

DataStore

• ckan_datastore_search 按资源搜索 DataStore 表

群组和标签

• ckan_group_list：列出所有群组
• ckan_tag_list：列出所有标签

资源

• ckan_resource_show：显示资源详细信息

系统

• ckan_site_read：站点信息
• ckan_status_show：状态和版本信息

示例

搜索包

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

显示组织

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

列出所有标签

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

资源

该服务还提供以下资源：

• ckan://api/docs：API 文档
• ckan://config：服务配置

与 MCP 客户端配合使用

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

{
  "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"
      }
    }
  }
}

其他 MCP 客户端

该服务通过 stdio 通信，因此任何兼容 MCP 的客户端都可以运行 Python 脚本并通过标准输入/输出与其通信。

CKAN API 参考

该 MCP 服务实现了 CKAN API v3 的主要端点。 完整文档：https://docs.ckan.org/en/latest/api/

许可证

Mozilla Public License Version 2.0

作者

(C) 2025，Ondics GmbH，https://ondics.de