项目简介

Prism MCP 服务器是一个本地的Model Context Protocol (MCP) 服务器,旨在帮助AI助手(如Claude Code、Cursor、GitHub Copilot等)与Prismatic API进行交互。它将Prismatic的命令行接口(CLI)功能封装为可由AI调用的“工具”,从而使AI能够执行如列出集成、初始化组件、测试流程等操作,极大地简化了代码原生集成和自定义组件的开发工作流。

主要功能点

  • 通用工具: 始终可用,用于检查Prismatic登录状态和列出可用组件。
  • 集成开发工具: 专注于集成相关操作,如列出、初始化、转换集成,管理和测试集成中的流程,以及生成集成相关代码(如流程文件、配置页面、配置变量等)。
  • 组件开发工具: 专注于组件相关操作,如初始化新组件、发布组件到Prismatic平台,以及生成组件类型清单。
  • 工具集按需启用: 支持通过环境变量或命令行参数选择性地启用“集成”或“组件”工具集,以优化性能。

安装步骤

  1. 安装Prism CLI: 在您的系统上全局安装Prismatic命令行工具。这是Prism MCP服务器操作Prismatic API的基础。
    npm install --global @prismatic-io/prism
  2. 登录Prismatic: 使用Prism CLI登录您的Prismatic账户。
    prism login
  3. 安装Prism MCP 服务器: Prism MCP 服务器通常作为AI助手配置的一部分通过'npx'按需运行,不需要单独全局安装。

服务器配置 (针对MCP客户端)

Prism MCP 服务器通过JSON-RPC协议与支持MCP的AI客户端通信。要将此服务器集成到您的AI助手中,您需要在AI助手的配置中添加以下JSON条目。请根据您AI助手的具体文件位置(例如'.mcp.json', 'claude_desktop_config.json', '.vscode/mcp.json'等)进行配置。

{
  "mcpServers": {
    "prism": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@prismatic-io/prism-mcp",
        "/path/to/your/work/directory/",
        // 可选参数:要启用的工具集。例如 "integration", "component"。
        // 如果不指定,则默认启用所有工具集。
        // 例如,只启用集成工具集: "integration"
      ],
      "env": {
        // 可选环境变量:指定Prismatic实例的URL,默认为 https://app.prismatic.io
        // "PRISMATIC_URL": "https://your-prismatic-instance.com"
      }
    }
  }
}

参数注释:

  • 'type': 通信协议类型,此处为 'stdio' (标准I/O)。
  • 'command': 启动MCP服务器的命令,此处为 'npx'。
  • 'args': 传递给 'npx' 命令的参数列表。
    • '"-y"': 确认 'npx' 提示。
    • '"@prismatic-io/prism-mcp"': Prism MCP 服务器的包名。
    • '"/path/to/your/work/directory/"': 必需参数。 这是Prism CLI命令将运行的工作目录的绝对路径。请将其替换为您的实际工作目录。
    • '[toolsets...]': 可选参数。 您可以选择性地指定要启用的工具集,例如 '"integration"' 或 '"component"'。如果您不提供任何工具集参数,所有工具将默认启用。选择性启用工具集有助于提升性能。
  • 'env': 可选环境变量。 您可以在这里设置额外的环境变量。
    • 'PRISMATIC_URL': 如果您的Prismatic实例不是默认的 'https://app.prismatic.io',请在此处指定其URL。

基本使用方法

配置完成后,您的AI助手将能够识别并调用由Prism MCP服务器提供的工具。例如,您可以向AI助手发出自然语言指令,请求它:

  • “列出我的所有Prismatic集成。” (AI助手将调用 'prism_integrations_list' 工具)
  • “初始化一个名为 'my-new-component' 的Prismatic组件。” (AI助手将调用 'prism_components_init' 工具)
  • “测试集成 'my-integration-id' 中的 'my-flow-name' 流程。” (AI助手将调用 'prism_integrations_flows_test' 工具)

AI助手会根据您的指令和内部逻辑选择合适的Prism MCP工具进行调用,并返回工具执行的结果。

信息

分类

开发者工具