README.md•2.85 kB
# @nanana-ai/mcp-server-nano-banana
MCP (Model Context Protocol) server for Nanana AI image generation service powered by Google Gemini's nano banana model. This server allows Claude Desktop and other MCP clients to generate and transform images using nano banana's powerful image generation capabilities.
## Installation
```bash
npm install -g @nanana-ai/mcp-server-nano-banana
```
## Configuration
### 1. Get your API token
1. Visit [nanana.app](https://nanana.app) and sign in
2. Go to your account dashboard
3. Generate an API token in the "API Access" section
4. Copy and save the token (it will only be shown once)
### 2. Configure Claude Desktop
Add the server to your Claude Desktop config file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"nanana": {
"command": "npx",
"args": ["-y", "@nanana-ai/mcp-server-nano-banana"],
"env": {
"NANANA_API_TOKEN": "your-api-token-here"
}
}
}
}
```
### 3. Restart Claude Desktop
After saving the config file, restart Claude Desktop to load the MCP server.
## Available Tools
### text_to_image
Generate an image from a text prompt.
**Parameters:**
- `prompt` (string, required): The text description of the image to generate
**Example:**
```
Generate an image of a cute cat wearing a hat
```
### image_to_image
Transform existing images based on a text prompt.
**Parameters:**
- `imageUrls` (array of strings, required): 1-9 image URLs to transform
- `prompt` (string, required): The text description of how to transform the images
**Example:**
```
Transform these images to look like oil paintings: ["https://example.com/image1.jpg"]
```
## Environment Variables
- `NANANA_API_TOKEN` (required): Your Nanana AI API token
- `NANANA_API_URL` (optional): Custom API URL (defaults to https://nanana.app)
## Development
### Local Testing
1. Clone the repository
2. Install dependencies: `npm install`
3. Build: `npm run build`
4. Test locally by updating Claude Desktop config to point to the built file:
```json
{
"mcpServers": {
"nanana": {
"command": "node",
"args": ["/path/to/packages/mcp-server/dist/index.js"],
"env": {
"NANANA_API_TOKEN": "your-token",
"NANANA_API_URL": "http://localhost:3000"
}
}
}
}
```
### Build
```bash
npm run build
```
### Watch mode
```bash
npm run dev
```
## Credits and Pricing
Image generation with nano banana consumes credits from your Nanana AI account. Check your dashboard at [nanana.app/account](https://nanana.app/account) to view your credit balance and purchase more credits if needed.
## Support
For issues and questions:
- Visit [nanana.app](https://nanana.app)
- Email: support@nanana.app
## License
MIT