prism-mcp

Prism MCP 服务是一个本地模型上下文协议（MCP）服务，可帮助 AI 助手使用 Prismatic API 进行代码原生集成和自定义组件开发。

说明

Prism 现已内置 MCP 支持！使用 Prism 11 或更高版本时，可通过 prism --mcp 启动服务。独立的 prism-mcp 包仍可使用，但已弃用，建议改用此内置支持。

如需了解如何通过编码助手构建和使用 Prismatic，请查看 Prismatic Agent 技能，这是我们 AI 开发指南的新入口。运行 npx skills add prismatic-io/agent-skills 即可开始使用。

功能

此 MCP 服务提供多个工具，并按类别组织。你可以注册与你的使用场景最相关的工具集。

通用工具（始终可用）

• prism_me：检查登录状态并显示当前用户的个人资料信息
• prism_components_list：列出所有可用组件及其版本选项

集成工具（工具集："integration"）

实用工具

• prism_integrations_list：列出所有集成
• prism_integrations_init：初始化新的代码原生集成
• prism_integrations_convert：将现有的低代码集成转换为代码原生集成
• prism_integrations_flows_list：列出某个集成的流程
• prism_integrations_flows_test：测试某个集成中的流程
• prism_integrations_flows_listen：将流程设为“监听模式”，以捕获 Webhook 负载或轮询触发器响应，并将其保存为供 prism_integrations_flows_test 使用的负载
• prism_integrations_import：从指定目录导入集成

代码生成

• prism_install_component_manifest：在 CNI src 目录中生成组件清单（需要 [email protected] 或更高版本）
• prism_install_legacy_component_manifest：生成一行内容，以便添加到 CNI 的 devDependencies 中，用于安装旧版组件清单
• prism_integrations_generate_flow：为 CNI 流程生成样板文件
• prism_integrations_generate_config_page：为 CNI 配置页面生成样板代码
• prism_integrations_generate_config_var：为配置变量生成样板代码
• prism_integrations_add_connection_config_var：如果可用，则返回连接包装函数的路径；否则生成连接配置变量的样板代码
• prism_integrations_add_datasource_config_var：如果可用，则返回数据源包装函数的路径；否则生成数据源配置变量的样板代码

组件工具（工具集："component"）

• prism_components_init：初始化新组件（支持 WSDL/OpenAPI 生成）
• prism_components_publish：从指定目录发布组件
• prism_components_generate_manifest：为 Prismatic 组件生成清单

工具集配置

工具按工具集组织，可在工作目录后传入工具集名称作为参数进行选择（参见命令行参数）：

• integration - 启用所有与集成相关的工具
• component - 启用所有与组件相关的工具
• 无论工具集配置如何，通用工具始终可用

如果未传入任何工具集参数，则默认注册所有工具。指定无法识别的工具集会导致启动错误。

前提条件

使用 Prismatic 进行身份验证。此服务打包了固定版本的 Prism CLI，因此无需为服务安装 CLI，但你需要先登录。安装 CLI 并运行登录命令（该命令会将凭据写入服务自动读取的共享配置文件），或者在无头/CI 环境中设置 PRISM_REFRESH_TOKEN。

npm install --global @prismatic-io/prism
prism login

用法

配置

配置位置和方法会因所用的 AI 工具而略有不同，但以下方式相对通用。更具体的说明见下文。

配置示例：

{
  "mcpServers": {
    "prism": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@prismatic-io/prism-mcp", "."],
      "env": {
        "PRISMATIC_URL": "https://app.prismatic.io"
      }
    }
  }
}

如果希望 MCP 服务在与当前打开的工作区不同的目录中运行，请将路径参数 . 替换为你的工作目录，

{
  "args": ["-y", "@prismatic-io/prism-mcp", "/path/to/code-native/integration"]
}

命令行参数：

• 第一个参数：必需。 工作目录路径，用于确定 Prism CLI 命令的运行位置。大多数编码 Agent（如 Cursor 和 Claude Code）会将 . 解释为当前工作区目录。如果你的编码 Agent 不支持此用法，可以改为指定代码原生集成或自定义组件项目的绝对路径。

• 其余参数：可选。 要启用的工具集（integration、component）。如果未指定工具集，默认注册所有工具。选择性启用工具集可能有助于提升性能。例如，仅启用与集成相关的工具：

  {
    "args": ["-y", "@prismatic-io/prism-mcp", ".", "integration"]
  }
  

可选的环境变量：

• PRISMATIC_URL：默认值为 https://app.prismatic.io。如果你的 Prismatic 租户托管在其他区域，或者你使用私有堆栈部署，请将此变量设置为你的 Prismatic URL。
• MCP_PRISM_PATH：指定要运行的 Prism CLI 的绝对路径，以替代捆绑版本（例如，本地构建的 CLI）。必须指向常规文件；否则将使用捆绑的 CLI。

使用 Claude Desktop 安装

将上述 JSON 配置添加到你的 claude_desktop_config.json 文件中。

使用 Claude Code 安装

要将此 MCP 服务与 Claude Code 配合使用，请将上述配置添加到工作目录中的 .mcp.json 配置文件。

或者，运行

claude mcp add-json prism '{"type":"stdio","command":"npx","args":["-y","@prismatic-io/prism-mcp","."],"env":{"PRISMATIC_URL":"https://app.prismatic.io"}}'

使用 Cursor 安装

你可以通过 Cursor Settings > MCP Tools 配置可用的 MCP 服务，然后将上述配置添加到 mcp.json 文件中。

或者，点击此链接自动安装：将 MCP 服务添加到 Cursor

使用 VS Code / GitHub Copilot 安装

将上述配置添加到工作区的 .vscode/mcp.json 文件中，或添加到全局 mcp.json 文件中（可通过命令面板中的“Add MCP Server...”选项访问）。

或者，点击此链接自动安装：将 MCP 服务添加到 VS Code

其他工具

如果你使用的 Agent 未列出，请参阅其官方文档以获取设置说明。

什么是 Prismatic？

Prismatic 是领先的嵌入式 iPaaS，可帮助 B2B SaaS 团队更快地交付产品集成，同时减少开发时间。Prismatic 是唯一一款同时为开发者和非开发者提供完整集成生命周期工具的嵌入式 iPaaS，包含低代码和原生代码构建选项、部署与管理工具，以及自助服务客户工具。

Prismatic 无与伦比的灵活性使团队能够在一个功能强大的平台上交付从简单到复杂的各种集成。全球各地的 SaaS 公司，从初创企业到《财富》500 强，都信赖 Prismatic，借此将自己的产品与客户使用的其他产品连接起来。

借助 Prismatic，你可以：

• 使用直观的低代码设计器或在首选 IDE 中采用原生代码方式构建集成
• 利用预构建的连接器完成常见集成任务，或使用我们的 TypeScript SDK 开发自定义连接器
• 在产品中嵌入原生集成市场，供客户自助使用
• 使用强大的配置工具配置并部署面向特定客户的集成实例
• 借助全面的日志记录、监控和警报高效地为客户提供支持
• 在专为 B2B SaaS 设计的安全、可扩展基础设施中运行集成
• 根据你的产品、行业和开发工作流定制平台

谁在使用 Prismatic？

Prismatic 专为需要向客户提供集成的 B2B 软件公司打造。无论你是不断成长的 SaaS 初创企业，还是成熟的大型企业，Prismatic 平台都能随着你的集成需求扩展。

我们的平台尤其适合服务专业垂直市场的团队。无论你要连接哪些系统，也无论集成需求多么独特，我们都能提供灵活性和工具，帮助你构建客户所需的集成。

使用 Prismatic 可以构建哪类集成？

Prismatic 支持各种复杂程度的集成——从简单的数据同步到复杂的行业专用解决方案。团队可以使用它构建不同类型系统之间的集成，无论是采用标准或自定义协议的现代 SaaS 系统，还是遗留系统。以下是一些示例用例：

• 将你的产品与客户的 ERP、CRM 和其他业务系统连接起来
• 根据特定客户的数据转换要求处理来自多个来源的数据
• 使用可自定义的触发器、操作和计划自动化工作流
• 处理复杂的身份验证流程和数据映射场景

如需了解 Prismatic 平台，请访问我们的网站和文档。

许可证

此代码仓库采用 MIT 许可证。