banana-prompts

This MCP server exposes Banana Prompts search capabilities via MCP-compatible clients. It lets you search for AI art prompts from Banana Prompts by tags or by a text query, returning results that include links to the full prompts and associated high‑resolution images on bananaprompts.fun. The available tools are search_prompts_by_tags, which accepts an array of tags to filter results, and search_prompts_by_query, which takes a free-form search string to find matching prompts. Use these tools through your MCP client (e.g., Claude Desktop) to quickly locate prompts that match your creative intent. The server is designed to integrate smoothly with Claude-like clients by exposing a simple toolset for retrieving curated prompts based on user input.

Prerequisites:

• Node.js v18 or higher
• An MCP-compatible client (e.g., Claude Desktop)

Installation steps:

1. Clone the repository and navigate into it: git clone https://github.com/Banana-Prompts/banana-prompts-mcp.git cd banana-prompts-mcp

2. Install dependencies: npm install

3. Build the project (if applicable): npm run build

4. Run the server using Node.js (example): node dist/index.js

Note: If your MCP client expects a specific entry file path, adjust the command args accordingly to point to the built dist/index.js. Ensure the server is reachable by your MCP client on the configured host/port defaults (check your environment or server setup for port exposure).

Tips and considerations:

• The server relies on a compiled dist/index.js. Ensure you run the build step if your repository uses a build process before starting the server.
• In Claude Desktop or other MCP clients, configure the mcpServers entry with the correct absolute path to dist/index.js on your machine.
• If you run behind a firewall or need a specific port, configure the host/port accordingly in your MCP client's settings or environment.
• No mandatory environment variables are specified for this server by default; add placeholders under env if you plan to inject API keys or custom configuration later (e.g., API_BASE_URL, BANANA_PROMPTS_API_KEY).
• If you encounter path resolution issues, ensure the path in the args array is absolute and accessible by the user running the server.