glif-mcp-server

用于从 glif.app 运行 AI 工作流的 MCP 服务器。

此服务器提供用于运行 glif、管理机器人以及通过模型上下文协议 (MCP) 访问 glif 元数据的工具。

此服务器还允许通过 add-tool、remove-tool 等元工具自定义所有可用工具，包括将完整的 glif 代理作为一组工具（和个性）。 这是一项高度实验性的功能。

有关更多信息，请访问 https://glif.app 或加入我们的 Discord 服务器：https://discord.gg/glif

功能

• 运行带有输入的 glif
• 获取有关 glif、运行和用户的详细信息
• 通过基于 URI 的资源访问 glif 元数据

设置

在本地安装和运行

首先，检出此代码并安装依赖项。 这假设您有一个较新版本的 Nodejs：

git clone https://github.com/glifxyz/glif-mcp-server
cd glif-mcp-server
npm install
npm run build
# 现在有一个 build/index.js 文件，这是我们接下来要运行的文件

然后配置您的 MCP 客户端（例如 Claude Desktop）以加载此服务器

1. 从 https://glif.app/settings/api-tokens 获取您的 API 令牌

2. 在您的 Claude Desktop 配置文件中添加服务器。 在 macOS 上，这是：~/Library/Application Support/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "glif": {
         "command": "node",
         "args": ["/path/to/glif-mcp/build/index.js"],
         "env": {
           "GLIF_API_TOKEN": "your-token-here"
         }
       }
     }
   }
   

您还可以指定 glif ID（以逗号分隔），这些 ID 将在服务器启动时自动加载。 这对于测试或如果您想与其他人共享预制的 glif 配置非常有用。

{
  "mcpServers": {
    "glif": {
      "command": "node",
      "args": ["/path/to/glif-mcp/build/index.js"],
      "env": {
        "GLIF_API_TOKEN": "your-token-here",
        "GLIF_IDS": "cm2v9aiga00008vfqdiximl2m,cm2v98jk6000r11afslqvooil,cm2v9rp66000bat9wr606qq6o",
        "IGNORE_SAVED_GLIFS": true,
      }
    }
  }
}


### 使用 Smithery 远程安装和运行

要通过 [Smithery](https://smithery.ai/server/@glifxyz/glif-mcp-server) 自动为 Claude Desktop 安装 glif-mcp，
Smithery 会为您托管和运行 MCP 服务器：

```bash
npx -y @smithery/cli install @glifxyz/glif-mcp-server --client claude

使用限制

• 受与用户帐户相同的限制
• 在 https://glif.app/pricing 购买更多积分

资源

• glif://{id} - 获取 glif 元数据
• glifRun://{id} - 获取运行详细信息
• glifUser://{id} - 获取用户个人资料

工具

常规 Glif 工具

• run_glif - 运行具有指定 ID 和输入的 glif
• glif_info - 获取有关 glif 的详细信息，包括输入字段
• list_featured_glifs - 获取精选的特色 glif 列表
• search_glifs - 按名称或描述搜索 glif

机器人工具

• list_bots - 获取特色机器人和模拟模板的列表
• load_bot - 获取有关特定机器人的详细信息，包括其技能
• save_bot_skills_as_tools - 将机器人的所有技能保存为单独的工具

用户特定工具

• my_glifs - 获取您的 glif 列表
• my_glif_user_info - 获取有关您的用户帐户、最近的 glif 和最近的运行的详细信息

Glif->工具 工具（元工具）

• save_glif_as_tool - 将 glif 保存为自定义工具
• remove_glif_tool - 删除已保存的 glif 工具
• remove_all_glif_tools - 删除所有已保存的 glif 工具并恢复到原始状态
• list_saved_glif_tools - 列出所有已保存的 glif 工具

如何将 glif 转换为自定义工具

我们有一个通用的 run_glif 工具，但它 (a) 不是很有描述性，并且 (b) 需要首先进行 glif_info 调用才能了解如何调用该 glif。 另外，您需要知道该 glif 存在。

我们正在试验几个新的元工具，这些工具将特定的 glif 转换为新的独立工具：

示例提示会话：

• 有什么很酷的新 glif 吗？
• [toolcall: list_featured_glifs...]
• 好的，我喜欢 1970 年代的科幻小说封面生成器，将其变成一个名为“scifi_book_image”的工具
• [toolcall: save_glif_as_tool glifId=... toolName=scifi_book_image]
• [现在用户只需键入“make sci fi book image of blah”]

您可以使用 list_saved_glif_tools 列出这些特殊工具，并使用 remove_glif_tool 删除任何您不喜欢的工具

请注意，Claude Desktop 需要重新启动才能加载新的工具定义。 Cline & Cursor 似乎会在更改时自动重新加载并重新查询可用工具

有关经过身份验证的用户的 glif 的信息：

• my_glifs - 当前用户发布的 glif（无草稿）
• my_liked_glifs - 当前用户喜欢的 glif
• my_runs - 当前用户的公共运行

开发

安装依赖项：

npm install

构建服务器：

npm run build

对于具有自动重建功能的开发：

npm run watch

要运行测试套件：

npm run test

要持续运行更改测试：

npm run test:watch

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

如果您使用的是 Claude Desktop，您还可以查看 Claude 日志目录中的 glif-mcp 日志。

MCP 注册表

<a href="https://glama.ai/mcp/servers/gwrql5ibq2"> <img width="380" height="200" src="https://glama.ai/mcp/servers/gwrql5ibq2/badge" alt="Glif MCP server" /> </a>

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。