glif-mcp-server

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

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

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

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

特徴

• 入力してGLIFSを実行する
• グリフ、実行、ユーザーに関する詳細情報を取得します
• URIベースのリソースを通じてglifメタデータにアクセスする

設定

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" } } } }

地元のレジから実行する

まず、このコードをチェックアウトして依存関係をインストールします。

次に、このサーバーをディスクからロードするように MCP クライアント (例: Claude Desktop) を構成します。

glifs ID（カンマ区切り）を指定することもできます。これらのIDはサーバーの起動時に自動的に読み込まれます。これはテストや、事前に作成したglif設定を他のユーザーと共有したい場合に便利です。

Smitheryでリモート実行

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

使用制限

• ユーザーアカウントと同じ制限が適用されます
• 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サーバーはstdio経由で通信するため、デバッグが困難になる場合があります。MCP Inspectorの使用をお勧めします。

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

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

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ファイルを参照してください。