格利夫-MCP服务器

Name: 格利夫-MCP服务器
Author: glifxyz

作者：glifxyz27 星标更新：2025-10-17

安装使用来源：spider==github.com

项目介绍

glif-mcp-server

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

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

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

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

功能

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

安装

通过npx运行（推荐）

如果你已安装了Node.js，可以通过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"
      }
    }
  }
}

你还可以指定glifs 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自动安装glif-mcp到Claude Desktop，Smithery会为你托管并运行MCP服务器：

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

使用限制

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

资源

glif://{id} - 获取glif元数据
glifRun://{id} - 获取运行详情
glifUser://{id} - 获取用户资料

配置

环境变量以控制哪些工具组被启用：

GLIF_API_TOKEN - 必需。 从https://glif.app/settings/api-tokens获取的API令牌
GLIF_IDS - 可选。逗号分隔的glif ID，自动加载为工具
IGNORE_DISCOVERY_TOOLS - 设置为true禁用发现工具（默认启用）
IGNORE_METASKILL_TOOLS - 设置为true禁用元技能工具（默认启用）
IGNORE_SAVED_GLIFS - 设置为true禁用保存的glif工具（默认启用）
BOT_TOOLS - 设置为true启用bot工具（默认禁用）

工具

核心工具（始终启用）

run_glif - 使用指定ID和输入运行一个glif
glif_info - 获取关于glif的详细信息，包括输入字段

发现工具（默认启用，使用`IGNORE_DISCOVERY_TOOLS=true`禁用）

list_featured_glifs - 获取精选glifs列表
search_glifs - 按名称或描述搜索glifs
my_glifs - 获取你的glifs列表
my_glif_user_info - 获取关于你的用户账户的详细信息，最近的glifs和运行

元技能工具（默认启用，使用`IGNORE_METASKILL_TOOLS=true`禁用）

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

Bot工具（默认禁用，使用`BOT_TOOLS=true`启用）

list_bots - 获取精选bots和sim模板列表
load_bot - 获取特定bot的详细信息，包括其技能
save_bot_skills_as_tools - 将bot的所有技能保存为独立工具
show_bot_info - 获取特定bot的详细信息

保存的Glif工具（默认启用，使用`IGNORE_SAVED_GLIFS=true`禁用）

从你使用元技能工具保存的glifs动态创建的工具。每个保存的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]
[现在用户可以直接键入“制作科幻小说封面图片”]

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

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

关于认证用户glifs的信息：

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

MCP注册表

开发

安装依赖项：

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 Actions将使用NPM_TOKEN密钥将其发布到NPM

许可证

本项目根据MIT许可证发布 - 详情见LICENSE文件。