项目简介
Prism MCP 服务器是一个本地的Model Context Protocol (MCP) 服务器,旨在帮助AI助手(如Claude Code、Cursor、GitHub Copilot等)与Prismatic API进行交互。它将Prismatic的命令行接口(CLI)功能封装为可由AI调用的“工具”,从而使AI能够执行如列出集成、初始化组件、测试流程等操作,极大地简化了代码原生集成和自定义组件的开发工作流。
主要功能点
- 通用工具: 始终可用,用于检查Prismatic登录状态和列出可用组件。
- 集成开发工具: 专注于集成相关操作,如列出、初始化、转换集成,管理和测试集成中的流程,以及生成集成相关代码(如流程文件、配置页面、配置变量等)。
- 组件开发工具: 专注于组件相关操作,如初始化新组件、发布组件到Prismatic平台,以及生成组件类型清单。
- 工具集按需启用: 支持通过环境变量或命令行参数选择性地启用“集成”或“组件”工具集,以优化性能。
安装步骤
- 安装Prism CLI: 在您的系统上全局安装Prismatic命令行工具。这是Prism MCP服务器操作Prismatic API的基础。
npm install --global @prismatic-io/prism - 登录Prismatic: 使用Prism CLI登录您的Prismatic账户。
prism login - 安装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工具进行调用,并返回工具执行的结果。
信息
分类
开发者工具