Mcp Server To Control Openrefine

OpenRefine MCP 服务

一个模型上下文协议（MCP）服务，为 OpenRefine 的 HTTP API 提供类型明确、易于发现的接口。任何支持 MCP 的客户端（例如 Claude Desktop）都可以通过它安全、可复现地编排数据清理流水线。

安装

前置条件

• Python 3.13 或更高版本
• uv 包管理器
• 正在运行的 OpenRefine 实例（默认：http://localhost:3333）

安装软件包

# Clone the repository
git clone <repository-url>
cd openrefine_mcp

# Install dependencies using uv
uv sync

配置 Claude Desktop

1. 创建或编辑 Claude Desktop 配置文件：

   # On macOS/Linux
   ~/.config/claude_desktop_config.json
   
   # On Windows
   %APPDATA%\claude_desktop_config.json
   

2. 将 OpenRefine MCP 服务添加到配置中：

   {
     "mcpServers": {
       "openrefine": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/your/openrefine_mcp",
           "run",
           "openrefine-mcp-server"
         ],
         "env": {
           "OPENREFINE_URL": "http://localhost:3333"
         }
       }
     }
   }
   

3. 重启 Claude Desktop 以加载新的 MCP 服务。

功能

此 MCP 服务实现了以下 OpenRefine API 端点：

OpenRefine API 端点	MCP 实现	状态
POST /command/core/create-project-from-upload	create_project(dataset_url: str, name: str | None = None)	✅
GET /command/core/get-models	get_project_models(project_id: int) 资源	✅
POST /command/core/apply-operations	apply_operations(project_id: int, operations: str)	✅
POST /command/core/export-rows	export_csv(project_id: int)	✅
POST /command/core/delete-project	delete_project(project_id: int)	✅
POST /command/core/set-project-metadata	-	❌
POST /command/core/set-project-tags	-	❌
GET /command/core/get-all-project-metadata	-	❌
POST /command/core/preview-expression	-	❌
GET /command/core/get-processes	-	❌

可用工具

• create_project(dataset_url: str, name: str | None = None) → 根据数据集 URL 创建新的 OpenRefine 项目
• apply_operations(project_id: int, operations: str) → 对 OpenRefine 项目应用操作
• export_csv(project_id: int) → 从 OpenRefine 项目导出 CSV 数据
• delete_project(project_id: int) → 删除 OpenRefine 项目

可用资源

• openrefine://project/{project_id}/models → 返回项目的结构信息，包括列定义、记录模型配置、可用脚本语言和叠加模型

开发

运行测试

make test

运行 MCP Inspector 服务

make inspector

许可证

本项目采用 MIT 许可证；详情请参阅 LICENSE 文件。