Simplifier Mcp

Simplifier MCP 服务

Simplifier 是 SAP 生态系统中的领先低代码平台。你可以在全栈低代码云开发环境中构建自定义应用，减少对全面编码的依赖。使用标准化连接器即可轻松与 ERP、CRM 和其他系统集成。

如需了解更多信息，请访问我们的社区，或免费试用 Simplifier。

---

此代码库包含一个 MCP 服务（Model Context Protocol），可将 AI 助手与 Simplifier Low Code Platform 集成。 它提供用于创建和管理 Simplifier 连接器与业务对象的工具和资源。

概览

Simplifier MCP 服务允许与 Simplifier 实例交互，以便：

• 管理连接器和登录信息：用于连接外部系统的集成组件
• 管理业务对象：在服务端执行、用于实现业务逻辑的 JavaScript 函数
• 管理数据类型：用于与连接器和内部对象交互的数据结构
• 执行业务对象函数：使用参数运行 JavaScript 函数并获取结果
• 执行连接器调用：通过 Simplifier 连接器调用外部系统
• 访问平台资源：浏览连接器、业务对象和系统信息

支持的连接器类型

目前仅完全支持以下连接器类型：

• REST
• SOAP
• SQL
• SAPRFC
• OData（仅代理；不支持连接器调用）

客户端兼容性

Simplifier MCP 服务通过两种并行接口提供数据，因此无论 MCP 客户端支持 MCP 协议的哪些部分，都能完整使用这些数据：

• 实现 MCP Resources 的客户端（例如 Claude Code、Claude Desktop、 MCP Inspector）可以通过 simplifier://… URI 浏览和读取 Simplifier 数据，例如 simplifier://businessobjects、 simplifier://connector/{name} 或 simplifier://documentation/…。
• 仅实现 MCP Tools 的客户端（例如 OpenCode、Cursor、Cline、 Continue、Windsurf）可以通过名为 *-list、*-get、documentation-get 和 connector-wizard-rfc-search 的工具获得等效的读取权限。

两种接口共用相同的底层实现，因此行为完全一致。在两者均可用时，客户端应优先使用资源。

用法

请参阅 Simplifier 社区文档， 了解如何使用和设置 MCP 服务。

身份验证

推荐的身份验证方式（适用于 Simplifier MC 26-11 或更高版本）是通过 SIMPLIFIER_APITOKEN 提供个人访问令牌（PAT）。 该令牌会作为 ApiToken 标头发送给 Simplifier，且不会随每次登录而变化，因此只需配置一次， 无需每天续期。以下所有示例均使用 SIMPLIFIER_APITOKEN。

也可以改用以下环境变量之一：

• SIMPLIFIER_TOKEN：当前的 SimplifierToken。每次登录 Simplifier 后都会变化（请参阅重新登录 Simplifier 后）。
• SIMPLIFIER_CREDENTIALS_FILE：包含 user 和 pass 的 JSON 文件路径，用于在启动时登录 Simplifier。

SIMPLIFIER_APITOKEN、SIMPLIFIER_TOKEN 和 SIMPLIFIER_CREDENTIALS_FILE 中只能设置一个。

将 MCP 添加到 claude code ...

使用 node / npx：

claude mcp add simplifier npx @simplifierag/simplifier-mcp@latest --env SIMPLIFIER_APITOKEN=<your personal access token> --env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud

使用 Docker：

claude mcp add simplifier-docker docker -- run --rm -i --env SIMPLIFIER_APITOKEN=<your personal access token> --env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud simplifierag/simplifier-mcp:latest

如果你的 Simplifier 部署在本地，则 DEV 实例的 SIMPLIFIER_BASE_URL 会与上述格式不同。

在 Simplifier 中重新登录后

仅当你使用 SIMPLIFIER_TOKEN 而非个人访问令牌时，才适用此说明。 每次登录 Simplifier 后，SimplifierToken 都会发生变化。因此，你需要：

• 退出 AI Agent（本例中为 claude），
• 然后移除 MCP 的配置

claude mcp remove simplifier

• 然后使用 --env SIMPLIFIER_TOKEN=<your current simplifier token> 而非 SIMPLIFIER_APITOKEN（参见上方命令）重新添加 MCP，并重启 AI Agent

……或使用此示例配置，让 claude code 使用 MCP

例如，将配置放在名为 .mcp.json 的文件中，并置于启动 claude 的目录下。

使用 node / npx：

{
  "mcpServers":  {
    "simplifier-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [ 
        "@simplifierag/simplifier-mcp@latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_APITOKEN": "<your personal access token>"
      }
    }
  }
}

使用 Docker：

{
  "mcpServers": {
    "simplifier-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "SIMPLIFIER_APITOKEN",
        "--env",
        "SIMPLIFIER_BASE_URL",
        "simplifierag/simplifier-mcp:latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_APITOKEN": "<your personal access token>"
      }
    }
  }
}

故障排除

如果 MCP 在启动时无法连接到 Simplifier，浏览器中会打开一个错误页面， 其中包含故障详情以及解决问题的方法。