mcp-registry/piapi-mcp-server

    ==================
      
       /// MCP ///
      /// PIA ///
        
    ==================
        
    [server:online]
    [protocol:ready]

piapi-mcp-server

by apinetwork

TypeScript implementation of a Model Context Protocol (MCP) server that connects Claude/Cursor (or any MCP-compatible client) to the PiAPI media-generation API.

54
18
Open Source
GitHub

Installation

1. Prerequisites
• Node.js ≥ 18
• npm (comes with Node) or pnpm/yarn
• A PiAPI account + API key (needed at runtime)
2. Clone the repository
git clone https://github.com/apinetwork/piapi-mcp-server.git cd piapi-mcp-server
3. Install dependencies
npm install # or: pnpm install / yarn install
4. Build TypeScript (optional – dev mode uses ts-node)
npm run build # transpiles to ./dist
5. Configure environment
• Copy .env.example to .env (if provided) and set:
• Optionally configure model providers (Midjourney, Flux, etc.) tokens.
PIAPI_KEY=YOUR_PIAPI_KEY PORT=8080 # or any free port
6. Run the server
# Development (ts-node + auto-reload) npm run dev # Production (compiled JS) npm start
7. Access
The MCP server will listen on http://localhost:<PORT>/mcp .
8. Reverse proxy (optional)
For public deployments, place Nginx/Caddy/Cloudflare Tunnel in front with HTTPS termination.

Documentation

License: MIT License
Updated 7/30/2025