xbloom-ai-mcp
这是一个非官方的、由社区构建的MCP服务器。它与xBloom没有关联，也没有得到xBloom的认可。 这个项目起源于 去核0/xbloom试剂 并且此后已被大幅重写。
一个MCP（模型上下文协议）服务器，将Claude连接到您的xBloom Studio配方。通过对话创建、编辑和管理咖啡和茶食谱，并将其直接同步到xBloom iOS应用程序。
______________________________________________________________________
先决条件
- Docker和Docker Compose
- 可公开访问的HTTPS端点（具有反向代理或Cloudflare Tunnel等服务的域名）
- 一个xBloom帐户
- Claude Pro、Max、团队或企业计划
______________________________________________________________________
安装
1.（可选）创建数据目录
只有当您想要持久的用户首选项时，才需要数据目录。这涉及一个标记文件，Claude可以在其中存储您的酿造偏好、豆子历史和容器更新中的品尝笔记。文件将在首次运行时创建，并由Claude定期更新。用户可以随时更新文件。
mkdir -p /path/to/xbloom-data如果跳过此步骤，服务器仍将完全工作。它只需要有持久的偏好。如果稍后添加卷装载，服务器将在首次运行时根据模板自动创建首选项文件。
2.创建您的撰写文件
复制 compose.yaml 从这个仓库中，通过 .env 文件。看 .env.example 对于所有必需的变量。如果创建了数据目录，请在中更新卷装载路径 compose.yaml.
3.生成秘密
openssl rand -hex 32 # use for MCP_AUTH_TOKEN
openssl rand -hex 32 # use for OAUTH_CLIENT_SECRET4.启动容器
docker compose up -d______________________________________________________________________
配置
| 变量 | 必填 | 描述 |
|---|---|---|
XBLOOM_EMAIL | 是 | 您的xBloom帐户电子邮件 |
XBLOOM_PASSWORD | 是 | 您的xBloom帐户密码 |
MCP_BASE_URL | 是 | 您服务器的公共HTTPS URL（例如。 https://coffee.yourdomain.com) |
MCP_AUTH_TOKEN | 是 | MCP请求的承载令牌\*\* |
OAUTH_CLIENT_SECRET | 是 | 添加Claude连接器时输入的密码\*\* |
\*\*生成与 openssl rand -hex 32
______________________________________________________________________
云耀
如果你的域名是通过Cloudflare代理的，你必须在你的机器人管理规则中允许Claude的用户代理。在Cloudflare控制面板的“安全”下，找到托管的“管理AI机器人”规则或“AI爬行控制”设置，并设置 Claude-User 到 允许。否则，Cloudflare将阻止来自Claude基础设施的所有请求。
______________________________________________________________________
连接克劳德
- 转到Claude.ai→ 设置→ 连接器→ 添加自定义连接器
- 输入你的
MCP_BASE_URL作为服务器URL - 点击 高级设置 并输入：
- OAuth客户端ID: xbloom-mcp-client - OAuth客户端密码： 你的 OAUTH_CLIENT_SECRET 价值
- 点击 添加 并完成OAuth流程
只有知道的人 OAUTH_CLIENT_SECRET 可以成功添加连接器。
______________________________________________________________________
工具
| 工具 | 说明 |
|---|---|
xbloom_list_recipes | 列出所有带有ID的食谱 |
xbloom_create_recipe | 创建新的咖啡配方 |
xbloom_create_tea_recipe | 创建新的茶配方 |
xbloom_edit_recipe | 按ID编辑现有配方 |
xbloom_delete_recipe | 删除配方 |
xbloom_fetch_recipe | 从共享URL导入食谱 |
xbloom_update_preferences | 写入持久用户首选项文件 |
xbloom_read_resource | 读取服务器资源文件（首选项、酿造参考、自定义说明） |
______________________________________________________________________
首选项查看器
您的用户偏好文件可以在任何浏览器中查看，网址为：
https://your-domain.com/preferences?token=YOUR_MCP_AUTH_TOKEN______________________________________________________________________
许可证
MIT。请参阅原始项目以获取先前的版权声明。