Bloomy MCP

用于与 Bloom Growth 的 GraphQL API 交互的模型上下文协议 (MCP) 服务器。

概述

Bloomy MCP 是一个连接到 Bloom Growth 的 GraphQL API 并通过模型上下文协议公开它的服务器，使 AI 助手能够针对 Bloom Growth 平台执行操作。

特征

• 通过 MCP 查询 Bloom Growth GraphQL API
• 检索查询和突变详细信息
• 通过 MCP 工具执行 GraphQL 查询和变更
• 获取已认证用户信息
• 自动模式自省

安装

先决条件

• Python 3.12 或更高版本
• 访问 Bloom Growth API
• uv （推荐）或 pip 用于包管理

包管理

本项目推荐使用uv ，这是一个快速的 Python 软件包安装程序和解析器，可以作为 pip/pip-tools 的直接替代品。它比传统的软件包管理器速度快得多。

安装 uv

其他安装方法请参见uv文档。

设置

1. 克隆此存储库
2. 设置 Python 虚拟环境：
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 以开发模式安装包：使用 pip：
   pip install -e .
   使用 uv（推荐）：
   uv pip install -e .
   对于开发依赖项：
   uv pip install -e ".[dev]"

环境变量

使用以下变量创建.env文件：

用法

光标集成

要将此 MCP 服务器与 Cursor（AI 驱动的 IDE）一起使用：

1. 前往“光标”>“光标设置”>“MCP”
2. 点击“添加新的 MCP 服务器”
3. 使用以下详细信息配置服务器：
   • 名称：“Bloom Growth”（或“BG”或您喜欢的任何名称）
   • 类型：命令
   • 命令： uv run --project /path/to/your/repo/ --env-file /path/to/your/repo/.env bloomy-server

   重要提示：将/path/to/your/repo/替换为您的 bloomy-mcp 存储库的实际路径（例如， /Users/username/workspace/bloomy-mcp/ ）。

运行服务器

启动 Bloomy MCP 服务器：

开发模式检查

为了开发和调试目的，您可以使用 MCP 检查器工具：

这使您可以在开发过程中检查 MCP 服务器的行为和响应。

推荐工具

为了获得最佳开发工作流程：

• direnv ：用于管理环境变量，并在进入项目目录时自动加载它们
• uv ：用于快速可靠的包管理

设置 direnv：

1. 安装 direnv（例如，在 macOS 上brew install direnv ）
2. 在项目根目录中创建一个.envrc文件：
   export BLOOM_API_URL=your_api_url export BLOOM_API_TOKEN=your_api_token
3. 运行direnv allow授权环境变量

这种工具组合（direnv + uv）为秘密管理和包管理提供了高效的环境。

可用的 MCP 工具

以下 MCP 工具可供 AI 助手使用：

• get_query_details - 获取有关特定 GraphQL 查询的详细信息
• get_mutation_details - 获取有关特定 GraphQL 突变的详细信息
• execute_query带有变量的 GraphQL 查询或变异
• get_authenticated_user_id - 获取当前已验证用户的 ID

可用的 MCP 资源

• bloom://queries - 获取所有可用查询的列表
• bloom://mutations - 获取所有可用突变的列表

发展

项目结构

依赖项

• mcp[cli] - 模型上下文协议服务器
• gql -GraphQL 客户端库
• httpx ——HTTP 客户端
• pyyaml ——YAML 处理