glif-mcp-server

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

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

该服务器还允许通过 add-tool, remove-tool 等元工具自定义所有可用工具，包括将完整的 glif 代理作为一组工具（和个人）。这非常具有实验性。

更多信息请参阅 https://glif.app 或加入我们的 Discord 服务器: https://discord.gg/glif

功能

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

设置

安装并本地运行

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

git clone https://github.com/glifxyz/glif-mcp-server
cd glif-mcp-server
npm install
npm run build
# there's now a build/index.js file which is what we'll run next

然后配置您的 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"
         }
       }
     }
   }
   

您还可以指定 glifs 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,
      }
    }
  }
}


### Install and run remotely with Smithery

To install glif-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@glifxyz/glif-mcp-server),
which hosts and runs the MCP server for you:

```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 - 获取精选 glifs 列表
• search_glifs - 按名称或描述搜索 glifs

机器人工具

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

用户特定工具

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

Glif->Tool 工具（元工具）

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

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

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

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

一个示例提示会话：

• 有哪些很酷的新 glifs？
• [工具调用: list_featured_glifs...]
• 好的，我喜欢 1970 年代科幻小说封面生成器，把它变成一个名为 "scifi_book_image" 的工具
• [工具调用: 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 似乎会在更改后自动重新加载并重新查询可用工具

关于已认证用户的 glifs 信息：

• my_glifs - 当前用户的已发布 glifs（不包括草稿）
• my_liked_glifs - 当前用户点赞的 glifs
• 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 注册表

许可证

此项目根据 MIT 许可证许可 - 详情请参阅 LICENSE 文件。