ShaderBase MCP 服务器

关键词

shader registryThree.jsGLSL shaderAI shader submissionJSON-RPC

使用说明（Markdown 格式）

  • 项目简介

    • ShaderBase MCP 服务器是一个基于 Model Context Protocol 的后端服务，专为 AI/LLM 客户端提供对着色器资源的访问、工具调用以及 Prompts 的渲染与执行能力。实现以 Cloudflare Worker 形式运行，支持 MCP 的 JSON-RPC 交互，以及一些传统的 HTTP 端点以便落地与调试。

  • 主要功能点

    • MCP 核心协议处理：实现 initialize、notifications/initialized、工具列表、工具调用、ping 等 JSON-RPC 请求与响应，包含错误处理、204 无响应通知等行为。
    • 工具与接口：提供 search_shaders、get_shader、submit_shader 等工具的实现，以及工具调用的 MCP 格式入口。
    • 兼容端点（Legacy HTTP endpoints）：/health、/tools、/search_shaders、/get_shader、/submit_shader 等，方便本地调试与集成。
    • CORS 与 HTTP 传输支持：对 MCP 客户端及浏览器请求进行合适的 CORS 头设置，保持跨域友好。
    • 会话与错误处理：初始化时返回服务器信息与能力声明，未知方法返回标准错误码，非法请求返回解析错误等。

  • 安装步骤

    • 该 MCP 服务器以 Cloudflare Worker 形式部署运行；请按照你们的部署流程将 Worker 发布到目标域名下，并确保可以通过 /mcp 路径访问。环境变量按需配置（如 Registry URL 等），若在本地进行测试，请确保能够通过模拟请求访问 /mcp。

  • 服务器配置（MCP 客户端使用信息） 说明：MCP 客户端需要提供一个配置，用于告诉它连接到哪个 MCP 服务器、以及启动方式（命令与参数）。下方给出一个可读的配置示例字段说明。注意：实际客户端可能不需要直接执行“命令”，但为了与题设要求对接，提供了可操作的描述信息。

    • serverName: ShaderBase
    • endpoint: https://mcp.shaderbase.com/mcp
    • startCommand: wrangler dev
    • startArgs: [“--port”, “8787”]
    • 备注: 该配置用于描述如何启动/连接到 MCP 服务器。字段 endpoint 指向 MCP 服务器的 /mcp 路径，客户端首次发送 initialize 请求以获取协议版本、能力、服务器信息等。

    配置示例（JSON 格式，文本说明字段含义在上方说明中）： { "serverName": "ShaderBase", "endpoint": "https://mcp.shaderbase.com/mcp", "startCommand": "wrangler dev", "startArgs": ["--port", "8787"] }

  • 基本使用方法

    • 启动并连接：将上述配置提供给 MCP 客户端，启动服务器后客户端会向 /mcp 发送 initialize 请求，服务器返回 protocolVersion、capabilities、serverInfo 等数据。
    • 使用工具：客户端在 initialize 之后即可通过工具列表（tools/list）等接口获知可用工具与参数，并通过工具调用执行相应操作（如 shader 搜索、获取详细信息、提交着色器等）。
    • 兼容性与错误：若请求方法未被实现，服务器返回 -32601 错误；请遵循 MCP 协议的规范进行调用。CORS 头部确保跨域环境下的正常访问。

服务器信息

访问项目