Ressourcespace MCP

ResourceSpace MCP 服务器

一个全面的模型上下文协议（MCP）服务器，提供对ResourceSpace数字资产管理（DAM）API的全面访问。该服务器将100多个ResourceSpace API端点作为MCP工具公开，同时还提供可浏览的资源和工作流提示。

🎯 多服务器架构

为了达到最佳性能，ResourceSpace MCP被划分为 4台模块化服务器:

• 主服务器 (44种工具) - 核心数字资产管理（DAM）操作
• 管理服务器 (18种工具) - 用户与系统管理
• IIIF服务器 (5种工具) - IIIF图像协议
• 同意管理服务器 (8种工具) - 同意管理插件

总计：75个工具 （所有服务器均在Cursor IDE推荐的80个工具限制之内）

👉 看 MULTI_SERVER_GUIDE.md 翻译为中文是：“多服务器指南.md” 完整的设置说明

特性/特点

• 75个MCP工具资源空间API的整合与高效覆盖

- 主服务器（44个工具）资源（8），搜索（7），集合（8），元数据（12），批量（9） - 管理服务器（18种工具）用户（8），系统操作（10） - IIIF 服务器（5种工具）支持IIIF协议 - 同意服务器（8种工具）同意管理 - 使用操作参数整合CRUD操作以实现最佳性能

• MCP Resources（公司名，可译为“MCP资源公司”或根据具体语境调整）基于URI的可浏览资产和集合访问

- resource://assets/{id} - 资产详情 - resource://assets/search?query={q} - 搜索结果 - resource://collections/{id} - 收藏内容 - 以及更多。。。

• MCP 提示常见任务的工作流模板

- 资产上传工作流 - 搜索与筛选工作流程 - 藏品管理 - 元数据丰富化 - 用户入职/引导（或“用户上手”） - 系统健康检查

从GitHub安装

先决条件

• Node.js 18+ 和 npm
• 一个具有API访问权限的ResourceSpace实例
• 资源空间API凭证（用户和API密钥）

快速安装

# Clone the repository
git clone https://github.com/Magnolia-Tech-Services-LLC/ressourcespaceMCP.git
cd ressourcespaceMCP

# Install dependencies and build (auto-builds via postinstall)
npm install

# Install globally to make commands available everywhere
npm link

搞定！服务器现在可以作为全局命令使用了。

可用命令

安装后，您将可以访问4台MCP服务器：

• resourcespace-mcp-server - 主服务器 (44种工具) - 核心数字资产管理（DAM）操作
• resourcespace-admin-mcp - 管理服务器 (18种工具) - 用户与系统管理
• resourcespace-iiif-mcp - IIIF 服务器 （5种工具）- IIIF图像协议
• resourcespace-consent-mcp - 同意管理器 (8种工具) - 同意插件

配置

Cursor IDE 配置

添加到你的Cursor MCP配置文件中（~/.cursor/mcp.json 或者 .cursor/mcp.json （在你的项目中）：

{
  "mcpServers": {
    "resourcespace": {
      "command": "resourcespace-mcp-server",
      "env": {
        "RESOURCESPACE_URL": "https://your-instance.com",
        "RESOURCESPACE_USER": "your-email@example.com",
        "RESOURCESPACE_API_KEY": "your-api-key-here"
      }
    },
    "resourcespace-admin": {
      "command": "resourcespace-admin-mcp",
      "env": {
        "RESOURCESPACE_URL": "https://your-instance.com",
        "RESOURCESPACE_USER": "your-email@example.com",
        "RESOURCESPACE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude 桌面配置

在您的Claude桌面配置文件中添加：

macOS（发音：/ˈmæk θiː əs/）： ~/Library/Application Support/Claude/claude_desktop_config.json\ Windows： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "resourcespace": {
      "command": "resourcespace-mcp-server",
      "env": {
        "RESOURCESPACE_URL": "https://your-instance.com",
        "RESOURCESPACE_USER": "your-email@example.com",
        "RESOURCESPACE_API_KEY": "your-api-key-here"
      }
    }
  }
}

注： 您可以启用这4台服务器中的任意组合。大多数用户仅需要主服务器。

获取您的API密钥

1. 登录到您的ResourceSpace实例
2. 首选 用户偏好 → API密钥
3. 生成一个新的API密钥
4. 复制密钥并在您的配置中使用它

看 MULTI_SERVER_GUIDE.md 翻译为中文是：“多服务器指南.md” 以下是每台服务器的详细设置说明和使用案例。

API覆盖率

资源管理工具

搜索与发现工具

收藏管理工具

元数据与字段工具

用户管理工具

系统操作工具

批处理操作工具

示例用法

搜索资产

// Using the do_search tool
{
  "search": "landscape mountains",
  "restypes": "1,2",
  "archive": 0,
  "per_page": 20,
  "order_by": "relevance"
}

创建并填充集合

// 1. Create collection
{
  "name": "Marketing Campaign 2024",
  "public": false,
  "allow_changes": true
}

// 2. Add resources
{
  "resource_ids": [101, 102, 103],
  "collection_id": 42
}

批量更新元数据

// Update copyright field for multiple resources
{
  "resource_ids": [101, 102, 103, 104],
  "field_id": 5,
  "value": "© 2024 Company Name"
}

认证

ResourceSpace 使用 MD5 签名认证。服务器会自动：

1. 构建包含用户和参数的查询字符串
2. 生成MD5哈希值： md5(API_KEY + query_string)
3. 在请求中附加签名

示例认证流程：

Query: user=admin&function=get_resource_data&param1=123
Sign: md5(YOUR_API_KEY + query_string)
URL: /api/?user=admin&function=get_resource_data&param1=123&sign=abc123...

错误处理

该服务器包含全面的错误处理机制：

• 网络错误自动重试，采用指数退避策略
• API错误带有详细信息的结构化错误响应
• 验证错误对所有输入进行Zod模式验证
• 超时处理可配置的请求超时时间

配置选项

所有配置均通过环境变量进行：

发展

项目结构

ressourcespaceMCP/
├── src/
│   ├── index.ts                 # Main MCP server
│   ├── config.ts                # Configuration management
│   ├── client/
│   │   └── resourcespace.ts     # API client
│   ├── tools/                   # MCP tools
│   │   ├── resources.ts
│   │   ├── search.ts
│   │   ├── collections.ts
│   │   ├── metadata.ts
│   │   ├── users.ts
│   │   ├── system.ts
│   │   └── batch.ts
│   ├── resources/               # MCP resources
│   │   ├── asset-browser.ts
│   │   └── collection-browser.ts
│   ├── prompts/                 # MCP prompts
│   │   └── templates.ts
│   └── types/
│       └── resourcespace.ts     # TypeScript types
├── package.json
├── tsconfig.json
└── README.md

建筑

npm run build

在开发中运行

npm run dev

故障排除

连接问题

1. 验证凭据请检查URL、用户名和API密钥 .env
2. 直接测试API使用ResourceSpace内置的API测试工具
3. 检查网络确保服务器能够访问ResourceSpace实例
4. 审查日志检查控制台输出以获取详细的错误信息

API 错误

• “无效的签名”API密钥不正确
• “函数未找到”ResourceSpace版本可能不支持该端点
• “权限被拒绝”用户缺少所需的权限
• 超时错误增加 REQUEST_TIMEOUT 价值

资源空间API文档

如需有关特定API端点的详细信息，请参阅官方ResourceSpace API文档： https://www.resourcespace.com/knowledge-base/api/ 的中文翻译是：“https://www.resourcespace.com/知识库/API/”。不过，通常在实际使用中，我们可能会简化为“资源空间API知识库”或类似表述，以更符合中文表达习惯。但直接翻译网址时，保留原格式更为常见

许可证

麻省理工学院（MIT）

贡献；助力

欢迎贡献！请在（项目/仓库）上提出问题或提交拉取请求 。

支持

对于此MCP服务器的相关问题，请 打开一个问题（或议题） 在GitHub上。

如需有关ResourceSpace API的问题，请参阅官方ResourceSpace文档。