Omeka S MCP Sample

Omeka S MCP 示例

本项目演示如何使用 MCP（Model Context Protocol）将 Omeka S API 与 Claude Desktop 集成。

该服务提供以下 Omeka S API 功能：

• 列出条目
• 获取条目详情
• 创建新条目
• 上传媒体（来自文件或 URL）

安装

1. 克隆此仓库
2. 安装依赖：

uv pip install -e .

配置

在项目根目录中创建 .env 文件，并填入 Omeka S API 凭据：

OMEKA_API_URL=https://your-omeka-s-instance/api
OMEKA_KEY_IDENTITY=your-key-identity
OMEKA_KEY_CREDENTIAL=your-key-credential

使用方法

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

"mcpServers": {
    "omeka-s-mcp-sample": {
        "command": "python",
        "args": [
            "/path/to/omeka-s-mcp-sample/server/omeka_server.py"
        ]
    }
}

说明

如果启动服务时收到 command not found 错误，请指定 Python 可执行文件的完整路径。

可用工具

该服务提供以下 MCP 工具：

list-items

列出 Omeka S 条目，支持分页。

get-item

按 ID 获取特定条目的详情。

create-item

创建包含标题和可选描述的新条目。

upload-media

从本地文件或 URL 向条目上传媒体。

使用示例

你可以让 Claude：

• 列出 Omeka S 实例中的条目
• 获取特定条目的详情
• 创建包含元数据的新条目
• 向条目上传媒体文件或 URL

开发

本项目使用：

• Python 3.10+
• MCP 1.6.0+
• aiohttp 发送 API 请求
• Ruff 进行代码格式化和检查