Manascb1344 Together MCP Server

🚀 Image Generation MCP Server

A server based on the Model Context Protocol (MCP) that supports seamless generation of high-quality images using Together AI's Flux.1 Schnell model. The server provides standardized interfaces to specify image generation parameters.

✨ Features

• Generate high-quality images using the Flux.1 Schnell model.
• Support custom dimensions (width and height).
• Provide clear error handling for prompt validation and API issues.
• Easy to integrate and compatible with MCP-compatible clients.
• Optional feature: Save images as PNG files to disk.

📦 Installation

npm install together-mcp

Or run directly:

npx together-mcp@latest

Configuration

Add the following content to the MCP server configuration:

{
  "mcpServers": {
    "together-image-gen": {
      "command": "npx",
      "args": ["together-mcp@latest -y"],
      "env": {
        "TOGETHER_API_KEY": "<API Key>"
      }
    }
  }
}

💻 Usage Examples

The server provides a tool: generate_image

Using generate_image

This tool has only one required parameter - the prompt. All other parameters are optional and will use default values if not specified.

Parameters

{
  // Required parameter: Prompt or instruction for image generation
  prompt: string;

  // Optional parameter: Number of images to generate, default is 1
  n?: number;

  // Optional parameter: Control output quality, default is 'high'
  quality?: 'low' | 'medium' | 'high';

  // Optional parameter: Specify image dimensions, e.g., 512x512
  width?: number;
  height?: number;
}

Example

Generate a high-quality image with a resolution of 512x512:

{
  "prompt": "A flying white swan",
  "n": 1,
  "quality": "high",
  "width": 512,
  "height": 512
}

Prerequisites

• Node.js version >= 16
• Together AI API Key
  1. Log in at api.together.xyz.
  2. Go to API Keys settings.
  3. Click "Create" to generate a new key.
  4. Copy the generated key for MCP configuration.

Dependencies

{
  "@modelcontextprotocol/sdk": "0.6.0",
  "axios": "^1.6.7"
}

Development

Clone and build the project:

git clone https://github.com/manascb1344/together-mcp-server
cd together-mcp-server
npm install
npm run build

Available Scripts

• npm run build: Build the TypeScript project.
• npm run watch: Monitor file changes and rebuild automatically.
• npm run inspector: Run the MCP inspection tool.

Contribution

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (feature/my-new-feature).
3. Commit your changes.
4. Push the branch to your personal repository.
5. Submit a Pull Request.

Feature requests and issue reports can be submitted via GitHub Issues. Please check for existing issues before submitting.

For major changes, please discuss your proposal through an Issue first.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.