Gaia MCP Server

Gaia MCP Server

⚠️ 非推奨

このリポジトリは非推奨となっており、現在は積極的にメンテナンスされていません。代わりに、新しい Go 実装をご利用ください。

👉 github.com/SipherAGI/gaia-mcp-go

Go 実装は、パフォーマンスの向上、簡単なインストール、継続的なメンテナンスを提供します。

ProtoGaia 向けの MCP（Model Context Protocol）サーバー実装であり、stdio と SSE（Server-Sent Events）の両方の通信方式をサポートしています。

目次

• はじめに
• インストール
• 使用方法
  • Claude Desktop との統合
  • Stdio 方式の使用
  • SSE 方式の使用
• MCP について
• API エンドポイント
• サポートされているツール
• お知らせ

はじめに

このパッケージには、ProtoGaia 向けの MCP サーバーの TypeScript 実装が含まれています。LLM（大規模言語モデル）が Model Context Protocol を使用して、外部のツールやサービスと通信するための標準化された方法を提供します。

インストール

Gaia MCP Server は、複数の方法で利用できます。

npx を使う（インストール不要）

インストールせずに npx を使ってサーバーを直接実行します。

# Run in SSE mode
npx @ather-mcp/gaia-mcp-server sse

# Run in stdio mode
npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key

グローバルインストール

パッケージをグローバルにインストールすると、どこからでも実行できます。

npm install -g @ather-mcp/gaia-mcp-server

その後、任意のターミナルから実行します。

# Run in SSE mode
gaia-mcp-server sse

# Run in stdio mode
gaia-mcp-server stdio --api-key=your-api-key

使用方法

サーバーは stdio または SSE の 2 つのモードで実行できます。コマンドラインインターフェイスを使用して、実行するモードを選択できます。

Claude Desktop との統合

Gaia MCP Server を Claude Desktop と統合すると、会話中に画像を直接生成できます。

1. Gaia API キーを取得する：

   • Gaia のウェブサイトにログインします
   • プロフィール画像からアカウント設定を開きます
   • 「Security」セクションに移動します
   • 新しい API キーを作成してコピーします

2. Claude Desktop を設定する：

   • Claude Desktop を開きます
   • 設定に移動します（Windows では File > Settings、Mac では Claude > Settings）
   • 「Developer」タブをクリックします
   • 「Edit config」ボタンをクリックします
   • 次のいずれかの設定内容に置き換えます。

   パッケージをグローバルにインストールした場合：

   {
     "mcpServers": {
       "gaia-mcp-server": {
         "command": "gaia-mcp-server",
         "args": ["stdio", "--api-key=YOUR_GAIA_API_KEY"]
       }
     }
   }
   

   npx を使用する場合（インストール不要）：

   {
     "mcpServers": {
       "gaia-mcp-server": {
         "command": "npx",
         "args": ["gaia-mcp-server", "stdio", "--api-key=YOUR_GAIA_API_KEY"]
       }
     }
   }
   

   YOUR_GAIA_API_KEY を実際の Gaia API キーに置き換えます。

3. Claude Desktop を再起動します

4. 統合をテストする：

   • 新しい会話を開始します
   • Claude に画像の生成を依頼します（例：「山々に沈む夕日の画像を生成して」）
   • 会話に画像が表示されます

詳しい手順とトラブルシューティングについては、Claude Desktop 統合ガイドをご覧ください。

Stdio 方式の使用

stdio 方式は、標準入力／出力ストリームを介してサーバーと直接通信する場合に便利です。通常、CLI ツールとの統合やローカルでの開発に使用されます。

サーバーを stdio モードで起動するには：

# Using npx
npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key

# Using globally installed package
gaia-mcp-server stdio --api-key=your-api-key

カスタム API URL も指定できます。

npx @ather-mcp/gaia-mcp-server stdio --api-key=your-api-key --api-url=https://your-custom-api-url

stdio 方式では、MCP プロトコル形式に従って、stdin／stdout を通じてサーバーと通信します。

stdio でメッセージを送信する例：

{ "type": "message", "data": { "content": "Your message content here" } }

SSE 方式の使用

SSE 方式では、HTTP 経由のサーバー送信イベント通信が可能なため、ウェブアプリケーションに適しています。

サーバーを SSE モードで起動するには：

# Using npx
npx @ather-mcp/gaia-mcp-server sse

# Using globally installed package
gaia-mcp-server sse

サーバーは、.env ファイルで指定されたポート（デフォルト：3000）で起動します。

SSE サーバーへの接続

SSE 接続を確立するには：

1. Gaia アカウントの API キーを指定して、/sse エンドポイントへの EventSource 接続を作成します。API キーの作成方法については、こちらをご覧ください。
2. /messages エンドポイントに POST リクエストを送信してメッセージを送ります。

クライアント側 JavaScript の例：

// Establish SSE connection
const eventSource = new EventSource('http://localhost:3000/sse?apiKey=your-gaia-account-api-key');
const sessionId = ''; // Will be populated from the first message

// Listen for messages
eventSource.onmessage = event => {
  const data = JSON.parse(event.data);

  // Store session ID from first message
  if (data.sessionId && !sessionId) {
    sessionId = data.sessionId;
  }

  console.log('Received:', data);
};

// Send a message
async function sendMessage(content) {
  await fetch('http://localhost:3000/messages', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      sessionId,
      message: {
        type: 'message',
        data: { content },
      },
    }),
  });
}

MCP の理解

Model Context Protocol（MCP）は、LLM が外部のツールやサービスとやり取りできるようにする標準化された通信プロトコルです。詳細はmodelcontextprotocol.ioをご覧ください。

MCP の主な概念：

• メッセージ：プロトコルにおける通信の基本単位
• ツール：モデルが呼び出せる関数
• トランスポート層：通信方法（stdio、SSE など）
• セッション：モデルとサーバー間の状態を保持するやり取り

このサーバー実装では、プロトコルの詳細を処理するために @modelcontextprotocol/sdk パッケージを使用しています。

API エンドポイント

SSE モードで実行する場合、次のエンドポイントを利用できます。

• GET /sse：SSE 接続を確立します
• POST /messages：サーバーにメッセージを送信します
• GET /health：ヘルスチェック用エンドポイント
• GET /：サーバーの基本情報

対応ツール

Gaia MCP Server は、LLM が呼び出せる画像の生成・加工用 AI ツールをいくつか提供しています。

• upload-image：URL から Gaia プラットフォームに画像をアップロードします
• create-style：提供された画像を使って Gaia プラットフォームに新しいスタイルを作成します
• generate-image：テキストプロンプトを基に Protogaia で画像を生成します
• remix：既存の画像から新しいバリエーションを作成します
• face-enhancer：既存の画像の顔のディテールを強化します
• upscaler：画像の解像度を向上させます

各ツールは MCP サーバーに登録され、Model Context Protocol 標準に従って呼び出すことができます。

ライセンス

Apache License 2.0

お知らせ

• 生成画像機能を利用するには、ユーザーが GAIA クレジットを保有している必要があります。残りのクレジットの確認と追加購入はこちらから行えます。