@ actionful/ mcp 工具

包含可重复使用的MCP(模式上下文协议)工具的工具包,用于内容。 这个软件包提供结构化工具集,包含完整的元数据,包括描述,输入计划,语义说明,以及工具执行等.

安装

npm install @contentful/mcp-tools

使用量

使用工具收藏

包导工具集按类别排列. 收藏中的每个工具包括:

• title: 工具名称
• description: 工具会做什么
• inputParams: Zod schema 或原始形状用于输入验证
• annotations:关于工具行为的语义提示(只读,有破坏性,有同能,有同能,有同能)
• tool: 实际工具执行功能

import { ContentfulMcpTools } from '@contentful/mcp-tools';
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

const server = new McpServer({ name: 'my-contentful-mcp', version: '1.0.0' });
const tools = new ContentfulMcpTools({
  accessToken: '<management-token>',
  mcpVersion: '1.0.0',
});

// Register a specific tool
const { searchEntries } = tools.getEntryTools();
server.registerTool(
  searchEntries.title,
  {
    description: searchEntries.description,
    inputSchema: searchEntries.inputParams,
    annotations: searchEntries.annotations,
  },
  searchEntries.tool,
);

// Register all tools from a collection
Object.values(tools.getAssetTools()).forEach((toolConfig) => {
  server.registerTool(
    toolConfig.title,
    {
      description: toolConfig.description,
      inputSchema: toolConfig.inputParams,
      annotations: toolConfig.annotations,
    },
    toolConfig.tool,
  );
});

数据大会写入输入

create_data_assembly 无需编辑即可配置 sys, (中文(简体) ), dataType,或 variant。 API 生成 sys.id 和推断 sys.dataType 从 return。 。 。 . parameters 是一个命令的、具有稳定状态的状态 id 和明确 布尔 required。删除参数的更新需要从 当前获取响应并保留服务器元数据。 坐标线 覆盖和工具分布,然后发布这个仅数组的合同. 这是一个中断的输入更改: 呼叫者仍然通过顶层 sys, (中文(简体) ), dataType, (中文(简体) ), 或者说 variant 获取验证错误。 升级时删除这些参数 . 嵌入式资源链接 sys 对象仍然是配置的一部分.

ContentfulMcpTools.getDataAssemblyTools() 将这些工具曝光给MCP主机. 本地服务器只在 ExO 工具 ENABLE_EXO_TOOLS 启用和 该组织拥有 exoM1 权利。 远程服务器也要求 页:1 exoM1 权利.

{
  "spaceId": "my-space",
  "environmentId": "master",
  "name": "Page title",
  "description": "A static page title",
  "parameters": [{ "id": "title", "type": "String", "required": false }],
  "resolvers": {},
  "return": { "$object": { "title": { "$literal": "Hello" } } }
}

update_data_assembly 使用组装ID和当前 sys.version 从 get_data_assembly。允许编辑的字段保留其当前值.

{
  "spaceId": "my-space",
  "environmentId": "master",
  "dataAssemblyId": "the-created-sys-id",
  "version": 3,
  "name": "Updated page title"
}

可用的工具收藏

收藏来自 ContentfulMcpTools 获取器,例如 getEntryTools(), (中文(简体) ), getAssetTools(), (中文(简体) ), getContentTypeTools(), (中文(简体) ), getReleaseTools(),以及 getDataAssemblyTools()。每个服务器只登记 ExO 收藏 当它的出入门口经过的时候.

工具说明

每个工具都包含语义说明来帮助MCP客户端理解工具行为:

• readOnlyHint数字 : true 如果工具只读取数据而不修改
• destructiveHint数字 : true 如果工具永久删除或删除数据
• idempotentHint数字 : true 如果使用相同的输入多次调用该工具,则产生相同的结果
• openWorldHint数字 : true 如果工具与外部服务或系统交互,则内容范围以外

可用的工具

配置

这些工具需要配置环境变量:

CONTENTFUL_MANAGEMENT_ACCESS_TOKEN=your_token_here
CONTENTFUL_HOST=api.contentful.com
SPACE_ID=your_space_id
ENVIRONMENT_ID=master

测试

所有工具包括综合单元测试。 以 :

npm test

许可证

麻省理工学院