Bloom Growth

🚀 Flower MCP Server

A Model Context Protocol (MCP) server for interacting with Bloom Growth's GraphQL API.

🚀 Quick Start

Flower MCP is a server that connects to Bloom Growth's GraphQL API and exposes it through the Model Context Protocol (MCP), enabling AI assistants to perform operations on the Bloom Growth platform.

✨ Features

• Query Bloom Growth's GraphQL API via MCP.
• Obtain detailed information about queries and mutations.
• Execute GraphQL queries and mutations using MCP tools.
• Retrieve detailed information about authenticated users.
• Automate schema exploration.

📦 Installation

Prerequisites

• Python 3.12 or higher.
• Access to the Bloom Growth API.
• uv (recommended) or pip for package management.

Package Management

This project recommends using uv, a fast Python package installer and resolver that can serve as a drop-in replacement for pip/pip-tools. It is significantly faster than traditional package management tools.

Install uv

curl -sSf https://astral.sh/uv/install.sh | sh

For other installation methods, refer to the uv documentation.

Setup Steps

1. Clone this repository.

2. Set up a Python virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install packages in development mode:

   Using pip:

   pip install -e .
   

   Using uv (recommended):

   uv pip install -e .
   

   Install development dependencies:

   uv pip install -e ".[dev]"
   

Environment Variables

Create a .env file containing the following variables:

BLOOM_API_URL=<Your Bloom API URL>
BLOOM_API_TOKEN=<Your Bloom API Token>

💻 Usage Examples

Cursor Integration

To integrate this MCP server with Cursor (an AI-powered IDE):

1. Go to Cursor > Cursor Settings > MCP.
2. Click "Add New MCP Server".
3. Configure the server as follows:
   • Name: "Bloom Growth" (or any other name you prefer).
   • Type: Command.
   • Command: uv run --project /path/to/your/repo/ --env-file /path/to/your/repo/.env flower-server

Note: Replace /path/to/your/repo/ with the actual repository path.

Running the MCP Server

1. Ensure that Python is installed and meets the version requirements.
2. Activate the virtual environment (if used).
3. Execute the command:

   uv run flower-server
   

📚 Documentation

The source code of the Flower MCP server is hosted on GitHub. Feel free to submit issues and pull requests.