AI导哈

实验管理服务器

Blok MCP Server是一个用于运行Blok实验的模型上下文协议服务器，支持从Claude Code或Claude Desktop创建、运行和监控实验。

  • by blok-intelligence
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 blok-intelligence/blok-mcp

使用说明

Blok MCP服务器

用于从Claude Code或Claude Desktop运行Blok实验的模型上下文协议（MCP）服务器。

特性

  • 认证：通过Supabase进行安全身份验证
  • 实验管理：创建、运行和监控实验
  • 人物选择：浏览并从可用角色中选择
  • ngrok集成：公开本地开发服务器进行测试
  • 实时结果：在实验完成时获取结果

安装

来源

git clone https://github.com/blok-intelligence/blok-mcp.git
cd blok-mcp
pip install -e .

使用pip（发布时）

pip install blok-mcp

配置

服务器可以通过环境变量进行配置：

变量 描述 默认值
BLOK_MCP_BLOK_API_URL 阻止 API 基础 URL。 https://app.joinblok.co
BLOK_MCP_WEB_URL Web仪表板URL 源自API URL
BLOK_MCP_DEBUG 启用调试日志记录 false

用法

本地运行

python -m blok_mcp

Claude代码设置

将MCP服务器添加到Claude代码中：

# Option 1: Authenticate via MCP tool
claude mcp add blok-experiments -- python -m blok_mcp

# Option 2: Pre-authenticate with token
ACCESS_TOKEN=$(curl -s -X POST https://app.joinblok.co/api/v1/auth/signin \
  -H 'Content-Type: application/json' \
  -d '{"email":"your@email.com","password":"your-password"}' | jq -r '.access_token')

claude mcp add blok-experiments -- python -m blok_mcp

Claude桌面设置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "blok-experiments": {
      "command": "python",
      "args": ["-m", "blok_mcp"],
      "env": {
        "BLOK_MCP_BLOK_API_URL": "https://app.joinblok.co"
      }
    }
  }
}

可用工具

认证

  • 我是谁 -使用电子邮件/密码进行身份验证并返回用户信息

人物角色

  • list_personas -列出所有可用于实验的角色

实验类型

  • 列表_实验_类型 -列出可用的实验类型模板

实验

  • start_实验 -创建并运行具有完整参数的新实验
  • create_experiment_from_description -用自然语言创建实验
  • 列表_实验 -列出过去使用可选过滤器的实验
  • get_experiment_results -获取实验的详细结果

ngrok隧道

  • start_ngrok -启动隧道以暴露本地端口
  • get_ngrok_status -检查活动隧道的状态
  • stop_ngrok -停止隧道

示例用法

# Authenticate
> mcp__blok-experiments__whoami(email="user@example.com", password="...")

# List personas
> mcp__blok-experiments__list_personas()

# Create and run an experiment
> mcp__blok-experiments__create_experiment_from_description(
    test_description="complete the checkout flow",
    url="https://mystore.com",
    persona_ids=["uuid-1", "uuid-2"]
  )

# Check results
> mcp__blok-experiments__get_experiment_results(experiment_id="...")

发展

设置

git clone https://github.com/blok-intelligence/blok-mcp.git
cd blok-mcp
pip install -e ".[dev]"

运行测试

pytest

代码质量

ruff check .
ruff format .

部署

可以使用附带的将服务器部署到Render render.yaml:

  1. 将您的GitHub仓库连接到Render
  2. 创建新的蓝图部署
  3. 配置环境变量：
    • BLOK_MCP_BLOK_API_URL=https://app.joinblok.co
    • BLOK_MCP_DEBUG=false

许可证

麻省理工学院

支持

  • 文档：https://docs.joinblok.co
  • 问题：https://github.com/blok-intelligence/blok-mcp/issues
  • 电子邮件：support@joinblok.co

相关 MCP