项目简介
Glif MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为 LLM 客户端提供 Glif 平台的功能和数据访问能力。它允许用户通过标准化的 MCP 协议,在 LLM 应用中运行 Glif 工作流、管理 Bot 助手,并获取 Glif 平台的元数据信息。
主要功能点
- Glif 工作流执行: 运行 Glif 平台上的 AI 工作流 (Glifs),并获取工作流的执行结果,例如生成图像、文本等。
- Glif 信息查询: 查询 Glif 平台上的各种信息,包括 Glif 的详细描述、输入参数、运行历史、用户信息等。
- Bot 助手管理: 发现和加载 Glif 平台上的 Bot 助手,获取 Bot 的技能列表和详细信息,甚至可以将 Bot 的技能转化为可调用的工具。
- 元数据资源访问: 通过标准的 URI 格式访问 Glif 平台上的元数据资源,例如 Glif 详情、Glif 运行详情和用户信息。
- 工具扩展与自定义: 支持动态添加、删除和管理工具,允许用户将 Glif 工作流保存为自定义工具,方便在 LLM 应用中直接调用。
- Prompt 模板: 提供预设的 Prompt 模板,例如展示精选 Glif 工作流,帮助用户快速上手和探索 Glif 平台的功能。
安装步骤
- 克隆仓库: 在您的本地计算机上克隆 'glif-mcp-server' 仓库的代码:
git clone https://github.com/glifxyz/glif-mcp-server - 进入目录: 使用 'cd' 命令进入克隆下来的仓库目录:
cd glif-mcp-server - 安装依赖: 运行 'npm install' 命令安装项目所需的依赖包:
npm install - 构建项目: 运行 'npm run build' 命令构建项目,生成可执行的服务器代码:
npm run build
服务器配置
要将 Glif MCP Server 集成到 MCP 客户端(例如 Claude Desktop),您需要在客户端的配置文件中添加服务器配置信息。以下是一个典型的 'claude_desktop_config.json' 配置文件示例,展示了如何配置 Glif MCP Server:
{ "mcpServers": { "glif": { // 服务器名称:您可以自定义此名称,用于在 MCP 客户端中标识该服务器。例如 "glif"。 "command": "node", // 启动命令:指定用于启动服务器的命令。这里 "node" 表示使用 Node.js 运行时环境。 "args": ["/path/to/glif-mcp/build/index.js"], // 命令参数:一个字符串数组,包含启动命令的参数。 // - "/path/to/glif-mcp/build/index.js" 需要替换为 glif-mcp-server 仓库中 'build/index.js' 文件的实际绝对路径。 "env": { "GLIF_API_TOKEN": "YOUR_API_TOKEN_HERE" // 环境变量:一个键值对对象,用于设置服务器运行时的环境变量。 // - "GLIF_API_TOKEN": "YOUR_API_TOKEN_HERE" 用于设置访问 Glif API 的身份验证 Token。 // "YOUR_API_TOKEN_HERE" 必须替换为您从 glif.app 网站获取的 API Token。 } } } }
配置步骤:
- 获取 API Token: 访问 https://glif.app/settings/api-tokens 登录您的 Glif 账号并获取 API Token。
- 编辑配置文件: 找到您的 MCP 客户端的配置文件(例如 Claude Desktop 的 'claude_desktop_config.json' 文件)。
- 添加服务器配置: 将上述 JSON 配置代码段添加到配置文件中的 '"mcpServers"' 字段下。
- 修改路径和 Token:
- 将 '"args"' 数组中的 '"/path/to/glif-mcp/build/index.js"' 替换为 glif-mcp-server 仓库中 'build/index.js' 文件的实际绝对路径。您需要根据您的文件系统结构进行调整,确保路径指向正确的文件。
- 将 '"env"' 对象中的 '"YOUR_API_TOKEN_HERE"' 替换为您在步骤 1 中获取的 Glif API Token。
基本使用方法
- 启动 MCP 服务器: 在完成安装和配置后,当您启动 MCP 客户端时,客户端会自动尝试连接到 Glif MCP Server。服务器会在后台运行,并通过标准输入/输出 (stdio) 与客户端进行通信。
- 使用工具和资源: 在 MCP 客户端中,您可以像使用其他任何 MCP 服务器提供的功能一样,使用 Glif MCP Server 提供的工具和资源。
- 工具调用: 您可以指示 LLM 客户端调用 Glif MCP Server 提供的工具,例如 'run_glif'(运行 Glif 工作流)、'glif_info'(查询 Glif 信息)、'list_bots'(列出 Bot 助手)等。具体的工具名称和参数请参考仓库的 README.md 文档中 "Tools" 部分的描述。
- 资源访问: 您可以使用 'glif://{id}'、'glifRun://{id}'、'glifUser://{id}' 等 URI 格式的资源链接,在 MCP 客户端中访问 Glif 平台上的元数据信息。例如,您可以让 LLM 客户端读取 'glif://cm2v9aiga00008vfqdiximl2m' 资源以获取 ID 为 'cm2v9aiga00008vfqdiximl2m' 的 Glif 的详细信息。
请注意: 首次添加或修改工具配置后,可能需要重启 MCP 客户端才能使配置生效。部分客户端(如 Cline, Cursor)可能支持自动重载工具配置。
信息
分类
AI与计算