glif-mcp-server

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

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

该服务器还允许通过添加工具、删除工具等元工具来自定义所有可用工具，包括将完整的 glif 代理作为一组工具（和个性）进行加载。这是高度实验性的。

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

功能

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

设置

通过 npx 运行（推荐）

如果您已安装 nodejs，可以通过 npx 运行我们的 @glifxyz/glif-mcp-server 包：

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

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

{
  "mcpServers": {
    "glif": {
      "command": "npx",
      "args": ["-y", "@glifxyz/glif-mcp-server@latest"],
      "env": {
        "GLIF_API_TOKEN": "your-token-here"
      }
    }
  }
}

从本地检出运行

首先，检出此代码并安装依赖项。

git clone https://github.com/glifxyz/glif-mcp-server
cd glif-mcp-server
npm install
npm run build
# 现在会生成一个 build/index.js 文件，接下来我们将运行它

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

{
  "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 自动为 Claude Desktop 安装 glif-mcp，它会为您托管和运行 MCP 服务器：

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？
[工具调用：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 似乎会在更改时自动重新加载并重新查询可用工具

有关已验证用户的 glif 的信息：

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

MCP 注册表

smithery 徽章

开发

安装依赖项：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run dev

运行测试套件：

npm run test

并在更改时持续运行测试：

npm run test:watch

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会很困难。我们建议使用 MCP Inspector：

npm run inspector

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

如果您使用的是 Claude Desktop，也可以直接在 Claude 日志中查看 glif-mcp 日志。

发布新版本

编辑 package.json 和 src/index.ts 并更新版本号
运行 npm install 以更新锁定文件中的版本
提交并将更改推送到 GitHub 并合并到主分支
如果您已安装 gh，切换到主分支并运行 npm run release，这将为新版本创建一个 git 标签，将该标签推送到 github，并使用 gh release create 发布一个带有自动生成变更日志的新版本。如果您没有 gh，可以在 GitHub Web UI 中手动执行上述操作
GitHub Action 将使用 NPM_TOKEN 密钥将其发布到 NPM

许可证

该项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。