PiAPI-MCP Server

by apinetwork

Integrations

  • Enables image generation from text descriptions through PiAPI's API

  • Planned integration for AI song generation through PiAPI's API

piapi-mcp-server

PiAPI APIと統合するModel Context Protocol(MCP)サーバーのTypeScript実装です。PiAPIを使用すると、Claudeやその他のMCP対応アプリから、Midjourney/Flux/Kling/LumaLabs/Udio/Chrip/Trellisを使用してメディアコンテンツを直接生成できます。

機能(近日中にさらに追加予定)

注意: ビデオ生成のような時間のかかるツールは、Claude のタイムアウト制限により完了しない可能性があります。

  • [x] ベースイメージツールキット
  • [x] ベースビデオツールキット
  • [x] テキスト/画像プロンプトからのFlux画像生成
  • [x] テキスト/画像プロンプトからのHunyuanビデオ生成
  • [x] Skyreels 画像プロンプトからのビデオ生成
  • [x] テキスト/画像プロンプトからのビデオ生成
  • [x] MMAudio ビデオからの音楽生成
  • [x] TTSゼロショット音声生成
  • [ ] 旅の途中の画像生成
    • [x] 想像する
    • [ ] 他の
  • [x] クリングビデオとエフェクトの生成
  • [x] Luma Dream Machineのビデオ生成
  • [x] スノミュージック世代
  • [ ] Suno 歌詞生成
  • [ ] オーディオ音楽と歌詞生成
  • [x] 画像からのトレリス3Dモデル生成
  • [ ] LLM内のワークフロー計画

Claude デスクトップ例の操作

前提条件

  • Node.js 16.x 以上
  • npmまたはyarn
  • PiAPI API キー ( piapi.aiで取得)

インストール

  1. リポジトリをクローンします。
git clone https://github.com/apinetwork/piapi-mcp-server cd piapi-mcp-server
  1. 依存関係をインストールします:
npm install
  1. プロジェクトをビルドします。
npm run build

ビルド後、 dist/index.jsファイルが生成されます。このファイルをClaude Desktopや他のアプリケーションで設定できます。詳細な設定手順については、「使用方法」セクションをご覧ください。

  1. (オプション) MCP Inspector を使用したテスト サーバー:

まず、プロジェクトのルート ディレクトリに API キーを使用して.envファイルを作成します。

PIAPI_API_KEY=your_api_key_here

次に、次のコマンドを実行して MCP Inspector を起動します。

npm run inspect

コマンドを実行すると、MCP Inspector がhttp://localhost:5173 (デフォルトポート: 5173) で利用可能になります。ブラウザでこの URL を開いてテストを開始してください。Inspector 操作のデフォルトのタイムアウトは 10000ms (10 秒) ですが、画像生成タスクには不十分な場合があります。画像生成などの時間のかかる操作をテストする場合は、タイムアウト値を増やすことをお勧めします。タイムアウト値を調整するには、URL にタイムアウトパラメータを追加します。例: http://localhost:5173?timeout=60000 (タイムアウトを 60 秒に設定)

MCP Inspectorは、MCPサーバーの実装をテストおよびデバッグするのに役立つ強力な開発ツールです。主な機能は次のとおりです。

  • インタラクティブテスト: Webインターフェースを通じてサーバーの機能を直接テストします
  • リアルタイムフィードバック:関数呼び出しの結果と発生したエラーを即時に確認します
  • リクエスト/レスポンス検査: リクエストとレスポンスの詳細情報を表示します
  • 関数ドキュメント: 利用可能な関数とそのパラメータを参照します
  • カスタムパラメータ: カスタムタイムアウト値やその他の構成オプションを設定します
  • 履歴追跡: 以前の関数呼び出しとその結果を追跡します

MCP インスペクターとその機能の使用方法の詳細については、公式の MCP ドキュメントをご覧ください。

使用法

Claudeデスクトップに接続しています

これを Claude Desktop 構成ファイル (macOS の場合は~/Library/Application Support/Claude/claude_desktop_config.json 、Windows の場合は%APPDATA%\Claude\claude_desktop_config.json ) に追加します。

{ "mcpServers": { "piapi": { "command": "node", "args": ["/absolute/path/to/piapi-mcp-server/dist/index.js"], "env": { "PIAPI_API_KEY": "your_api_key_here" } } } }

設定ファイルを更新したら、Claude for Desktopを再起動する必要があります。再起動すると、入力ボックスの右下にハンマーアイコンが表示されます。詳細については、 MCPの公式ドキュメントをご覧ください。

カーソルに接続

注: 以下のガイドはCursor 0.47.5に基づいています。機能や動作はバージョンによって異なる場合があります。

MCP サーバーを構成するには:

  1. 「ファイル > 設定 > カーソル設定」に移動するか、ショートカットキーCtrl+Shift+Jを使用します。
  2. 左パネルの「MCP」タブを選択します
  3. 右上の「新しいグローバルMCPサーバーを追加」ボタンをクリックします。
  4. 開いたmcp.jsonファイルに設定を追加します
{ "mcpServers": { "piapi": { "command": "node", "args": ["/absolute/path/to/piapi-mcp-server/dist/index.js"], "env": { "PIAPI_API_KEY": "your_api_key_here" } } } }
  1. 設定後、MCPサーバーページに「piapi」エントリが表示されます。
  2. エントリの更新ボタンをクリックするか、カーソルを再起動してpiapiサーバーに接続します。

piapi 画像生成をテストするには:

  1. カーソルチャットで「エージェントモード」を開いて選択するか、ショートカットキーCtrl+Iを使用します。
  2. テストプロンプトを入力します。例:「犬の画像を生成」
  3. 画像はpiapiサーバーを使用してプロンプトに基づいて生成されます

piapi サーバーを無効にするには:

  1. カーソル設定のMCPサーバーページに移動します
  2. サーバーリストで「piapi」エントリを見つけます
  3. 「有効」トグルボタンをクリックして「無効」に切り替えます

発達

プロジェクト構造

piapi-mcp-server/ ├── assets/ ├── src/ │ ├── index.ts # Main server entry point ├── package.json ├── tsconfig.json └── .env.example

ライセンス

マサチューセッツ工科大学

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

TypeScript ベースの Model Context Protocol (MCP) サーバー。MCP 互換アプリケーションを通じて Midjourney、Flux などのプラットフォームを使用してメディア コンテンツを生成するための PiAPI との統合を可能にします。

  1. Features (more coming soon)
    1. Working with Claude Desktop Example
      1. Prerequisites
        1. Installation
          1. Usage
            1. Connecting to Claude Desktop
            2. Connecting to Cursor
          2. Development
            1. Project Structure
          3. License

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.
              Last updated 3 months ago
              1
              5
              TypeScript
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
              Last updated a month ago
              Python
              MIT License
            • -
              security
              -
              license
              -
              quality
              A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
              Last updated 2 months ago
              1
              TypeScript
            • -
              security
              F
              license
              -
              quality
              A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
              Last updated a month ago
              67
              TypeScript
              • Apple

            View all related MCP servers

            ID: ywvke8xruo