Bloomy MCP

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

概述

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

Related MCP server: Confluence MCP

特征

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

安装

先决条件

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

包管理

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

安装 uv

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

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

设置

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

环境变量

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

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

用法

光标集成

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

前往“光标”>“光标设置”>“MCP”
点击“添加新的 MCP 服务器”
使用以下详细信息配置服务器：
- 名称：“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 服务器：

bloomy-server

开发模式检查

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

npx @modelcontextprotocol/inspector bloomy-server

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

可用的 MCP 工具

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

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

可用的 MCP 资源

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

发展

项目结构

src/ └── bloomy_mcp/ ├── __init__.py # Package initialization ├── client.py # GraphQL client implementation ├── formatters.py # Data formatting utilities ├── introspection.py # GraphQL schema introspection ├── operations.py # GraphQL operation utilities └── server.py # MCP server implementation