glif-mcp-server

glif.app から AI ワークフローを実行するための MCP サーバー。

このサーバーは、Glif の実行、ボットの管理、モデル コンテキスト プロトコル (MCP) を介した Glif メタデータへのアクセスを行うためのツールを提供します。

このサーバーでは、ツールの追加、ツールの削除などのメタツールを介して利用可能なすべてのツールをカスタマイズできます。これには、ツールセット（およびパーソナリティ）として提供される多くの完全なGlifエージェントも含まれます。これは非常に実験的なものです。

詳細については、 https://glif.appをご覧いただくか、Discord サーバーにご参加ください: https://discord.gg/glif

特徴

• 入力してGLIFSを実行する

• グリフ、実行、ユーザーに関する詳細情報を取得します

• URIベースのリソースを通じてglifメタデータにアクセスする

Related MCP server: Remote MCP Server (Authless)

設定

npx 経由で実行 (推奨)

Node.js がインストールされている場合は、npx 経由で@glifxyz/glif-mcp-serverパッケージを実行できます。

1. https://glif.app/settings/api-tokensから API トークンを取得します。

2. 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
# there's now a build/index.js file which is what we'll run next

次に、このサーバーをディスクからロードするように 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でリモート実行

MCP サーバーをホストして実行するSmithery経由で、Claude Desktop 用の glif-mcp を自動的にインストールするには、次の手順を実行します。

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

使用制限

• ユーザーアカウントと同じ制限が適用されます

• https://glif.app/pricingで追加のクレジットを購入してください

リソース

• glif://{id} - glf メタデータを取得します

• glifRun://{id} - 実行の詳細を取得する

• glifUser://{id} - ユーザープロファイルを取得する

ツール

一般的なGlifツール

• run_glif - 指定されたIDと入力でglifを実行する

• glif_info - 入力フィールドを含む glif の詳細情報を取得します

• list_featured_glifs - 注目のグリフの厳選リストを取得します

• search_glifs - 名前または説明でグリフを検索します

ボットツール

• list_bots - 注目のボットとシムテンプレートのリストを取得します

• load_bot - 特定のボットのスキルを含む詳細情報を取得します

• save_bot_skills_as_tools - ボットのすべてのスキルを個別のツールとして保存します

ユーザー固有のツール

• my_glifs - グリフのリストを取得する

• 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 ツールを一覧表示します

グリフをカスタムツールに変える方法

汎用的なrun_glifツールはありますが、(a)あまり説明的ではなく、(b)glifの呼び出し方法を知るためにまずglif_info呼び出す必要があります。さらに、glifが存在することさえ知っておく必要があります。

私たちは、特定のグリフを新しいスタンドアロン ツールに変えるいくつかの新しいメタ ツールを試しています。

プロンプトセッションの例:

• 新しいクールな GIF は何ですか?

• [ツールコール: list_featured_glifs ...]

• 1970年代のSF本の表紙ジェネレーターが気に入ったので、「scifi_book_image」というツールを作成します

• [ツールコール: save_glif_as_tool glifId=... toolName=scifi_book_image ]

• [これでユーザーは「何とかのSF本のイメージを作る」と入力するだけで済みます]

これらの特別なツールはlist_saved_glif_toolsでリストでき、不要なものはremove_glif_toolで削除できます。

Claude Desktopでは、新しいツール定義を読み込むために再起動が必要です。ClineとCursorは変更時に自動的に再読み込みされ、利用可能なツールを再クエリするようです。

認証されたユーザーのグリフに関する情報:

• my_glifs - 現在のユーザーが公開した glifs (drats なし)

• my_liked_glifs - 現在のユーザーが「いいね！」した glif

• 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

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

Claude Desktop を使用している場合は、Claude ログ ダイレクト内の glif-mcp ログを確認することもできます。

新バージョンのリリース

1. package.jsonとsrc/index.tsを編集してバージョン番号を上げる

2. npm install実行して、ロックファイルに保存されているバージョンを更新します。

3. 変更をGitHubにコミットしてプッシュし、メインにマージします

4. ghがインストールされている場合は、メインに切り替えてnpm run releaseを実行してください。これにより、新しいバージョンの git タグが作成され、そのタグが github にプッシュされます。その後gh release create 、自動生成された変更ログを含む新しいバージョンを公開します。gh ghインストールされていない場合は、GitHub の Web UI で上記の手順を手動で実行できます。

5. GitHub ActionはNPM_TOKENシークレットを使用してNPMに公開します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。