Bloomy MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API GraphQL de Bloom Growth.

Descripción general

Bloomy MCP es un servidor que se conecta a la API GraphQL de Bloom Growth y la expone a través del Protocolo de Contexto de Modelo, lo que permite a los asistentes de IA realizar operaciones contra la plataforma Bloom Growth.

Características

• Consulta la API GraphQL de Bloom Growth a través de MCP
• Recuperar detalles de consultas y mutaciones
• Ejecutar consultas y mutaciones GraphQL mediante herramientas MCP
• Obtener información de usuario autenticado
• Introspección automática de esquemas

Instalación

Prerrequisitos

• Python 3.12 o superior
• Acceso a la API de Bloom Growth
• uv (recomendado) o pip para la gestión de paquetes

Gestión de paquetes

Este proyecto recomienda usar uv , un rápido instalador y solucionador de paquetes de Python que reemplaza directamente a pip/pip-tools. Es significativamente más rápido que los gestores de paquetes tradicionales.

Instalación de uv

Para otros métodos de instalación, consulte la documentación de uv .

Configuración

1. Clonar este repositorio
2. Configurar un entorno virtual de Python:
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Instalar el paquete en modo de desarrollo:Usando pip:
   pip install -e .
   Uso de uv (recomendado):
   uv pip install -e .
   Para dependencias de desarrollo:
   uv pip install -e ".[dev]"

Variables de entorno

Crea un archivo .env con las siguientes variables:

Uso

Integración del cursor

Para utilizar este servidor MCP con Cursor (IDE impulsado por IA):

1. Vaya a Cursor > Configuración del cursor > MCP
2. Haga clic en "Agregar nuevo servidor MCP"
3. Configure el servidor con los siguientes detalles:
   • Nombre: "Bloom Growth" (o "BG" o cualquier nombre que prefieras)
   • Tipo: Comando
   • Comando: uv run --project /path/to/your/repo/ --env-file /path/to/your/repo/.env bloomy-server

   Importante : reemplace /path/to/your/repo/ con la ruta real a su repositorio bloomy-mcp (por ejemplo, /Users/username/workspace/bloomy-mcp/ ).

Ejecución del servidor

Inicie el servidor Bloomy MCP:

Inspección del modo de desarrollo

Para fines de desarrollo y depuración, puede utilizar la herramienta de inspección MCP:

Esto le permite inspeccionar el comportamiento y las respuestas del servidor MCP durante el desarrollo.

Herramientas recomendadas

Para un flujo de trabajo de desarrollo óptimo:

• direnv : se utiliza para administrar variables de entorno y cargarlas automáticamente al ingresar al directorio del proyecto
• uv : Úselo para una gestión de paquetes rápida y confiable

Configuración de direnv:

1. Instalar direnv (por ejemplo, brew install direnv en macOS)
2. Cree un archivo .envrc en la raíz de su proyecto:
   export BLOOM_API_URL=your_api_url export BLOOM_API_TOKEN=your_api_token
3. Ejecute direnv allow para autorizar las variables de entorno

Esta combinación de herramientas (direnv + uv) proporciona un entorno eficiente tanto para la gestión de secretos como para la gestión de paquetes.

Herramientas MCP disponibles

Las siguientes herramientas MCP están disponibles para los asistentes de IA:

• get_query_details : obtenga información detallada sobre consultas GraphQL específicas
• get_mutation_details : obtenga información detallada sobre mutaciones específicas de GraphQL
• execute_query - Ejecutar una consulta o mutación GraphQL con variables
• get_authenticated_user_id - Obtener el ID del usuario actualmente autenticado

Recursos MCP disponibles

• bloom://queries - Obtener una lista de todas las consultas disponibles
• bloom://mutations - Obtenga una lista de todas las mutaciones disponibles

Desarrollo

Estructura del proyecto

Dependencias

• mcp[cli] - Servidor de protocolo de contexto de modelo
• gql - Biblioteca cliente GraphQL
• httpx - Cliente HTTP
• pyyaml - Procesamiento de YAML