Bloom Growth

🚀 鲜花 MCP 服务器

鲜花 MCP 服务器是一个用于与 Bloom Growth 的 GraphQL API 进行交互的模型上下文协议（MCP）服务器，它能让人工智能助手在 Bloom Growth 平台上执行各类操作，为用户提供便捷的交互体验。

🚀 快速开始

鲜花 MCP 是一个连接到 Bloom Growth 的 GraphQL API 并通过 Model Context Protocol（MCP，模型上下文协议）进行暴露的服务器，使人工智能助手能够对 Bloom Growth 平台执行操作。

✨ 主要特性

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

📦 安装指南

先决条件

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

包管理

此项目建议使用 uv，这是一个快速的 Python 包安装程序和解析器，可作为 pip/pip-tools 的 drop-in 替代品。它的速度显著快于传统的包管理工具。

安装 uv

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

如需其他安装方法，请参考 uv 文档。

设置步骤

1. 克隆此仓库
2. 设置 Python 虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   

3. 开发模式下安装包：
   • 使用 pip：

   pip install -e .
   

   • 使用 uv（推荐）：

   uv pip install -e .
   

   • 安装开发依赖项：

   uv pip install -e ".[dev]"
   

环境变量

创建一个 .env 文件，包含以下变量：

BLOOM_API_URL=<你的 Bloom API URL>
BLOOM_API_TOKEN=<你的 Bloom API Token>

💻 使用示例

光标集成

要将此 MCP 服务器与 Cursor（AI 驱动的 IDE）集成：

1. 进入 Cursor > Cursor 设置 > MCP
2. 点击“添加新的 MCP 服务器”
3. 配置服务器如下：
   • 名称： "Bloom Growth"（或其他你喜欢的名字）
   • 类型： 命令
   • 命令： uv run --project /path/to/your/repo/ --env-file /path/to/your/repo/.env 鲜花-server

注意将 /path/to/your/repo/ 替换为实际仓库路径。

MCP 服务器运行

1. 确保已安装 Python 并且版本满足要求
2. 激活虚拟环境（如果使用）
3. 执行命令：

uv run 鲜花-server

📚 详细文档

鲜花 MCP 服务器的源代码托管在 GitHub，欢迎提交问题和拉取请求。