Together AI Image Server

Together AI Image Server

英語 | 简体中文

Together AI API を使用して画像を生成する、TypeScript ベースの MCP（Model Context Protocol）サーバーです。

概要

このサーバーは、MCP プロトコルを通じて Together AI の画像生成モデルを使用し、画像を生成するためのシンプルなインターフェースを提供します。Claude やその他の MCP 対応アシスタントが、テキストプロンプトに基づいて画像を生成できます。

機能

ツール

• generate_image - テキストプロンプトから画像を生成します
  • 必須パラメーターとしてテキストプロンプトを受け取ります
  • 生成ステップ数と画像枚数を制御するオプションパラメーターがあります
  • 生成した画像の URL とローカルパスを返します

前提条件

• Node.js（v14 以降を推奨）
• Together AI API キー

インストール

# Clone the repository
git clone https://github.com/zym9863/together-ai-image-server.git
cd together-ai-image-server

# Install dependencies
npm install

設定

Together AI API キーを環境変数として設定します。

# On Linux/macOS
export TOGETHER_API_KEY="your-api-key-here"

# On Windows (Command Prompt)
set TOGETHER_API_KEY=your-api-key-here

# On Windows (PowerShell)
$env:TOGETHER_API_KEY="your-api-key-here"

または、プロジェクトのルートに .env ファイルを作成できます。

TOGETHER_API_KEY=your-api-key-here

開発

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

Claude Desktop での使用

Claude Desktop で使用するには、サーバーの設定を追加します。

macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Together AI Image Server": {
      "command": "/path/to/together-ai-image-server/build/index.js"
    }
  }
}

/path/to/together-ai-image-server を実際のインストール先のパスに置き換えてください。

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

API リファレンス

generate_image

Together AI の画像生成 API を使用して、テキストプロンプトに基づいて画像を生成します。

パラメーター：

• prompt（string、必須）：画像生成用のテキストプロンプト
• steps（number、任意、デフォルト：4）：拡散ステップ数（1～4）
• n（number、任意、デフォルト：1）：生成する画像の枚数（1～4）

戻り値：

以下を含む JSON オブジェクト：

• image_urls：生成された画像の URL 配列
• local_paths：ローカルにキャッシュされた画像のパス配列

ライセンス

MIT

貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。