关键词

Airbyte连接器开发AI自动化连接器验证数据流测试清单管理

项目简介

Airbyte Connector Builder MCP 服务器是一个赋能AI自动完成 Airbyte 连接器开发流程的后端服务。它允许AI代理执行连接器清单验证、数据流测试、配置管理、生成连接器骨架以及安全处理敏感凭证等任务。通过标准化的 MCP 协议，LLM客户端可以无缝地调用这些功能，实现连接器从开发到PR创建的端到端自动化。

主要功能点

  • 连接器清单操作: 验证和解析连接器清单文件（manifest）。
  • 数据流测试: 测试连接器从指定数据流读取数据的能力，并提供详细的测试结果和日志。
  • 配置管理: 验证连接器配置，并支持从环境变量文件 ('.env') 或 Privatebin URL 安全地注入敏感信息。
  • 测试执行: 运行连接器就绪度测试报告，评估所有数据流的健康状况和数据提取性能。
  • 清单骨架生成: 根据用户提供的API信息，生成基础的连接器清单YAML文件骨架。
  • 文档和开发指南: 提供全面的连接器开发清单和特定主题的详细文档，帮助AI理解和遵循最佳实践。
  • 按组件查找连接器: 搜索使用特定声明式组件类的现有连接器。
  • 获取现有连接器清单: 从Airbyte连接器注册表获取只包含清单的连接器YAML内容。

安装步骤

  1. Python环境: 确保您已安装 Python (3.9+) 和 'uv' (或 'pip')。
  2. 安装项目:
    • 稳定版本: 
      uv pip install airbyte-connector-builder-mcp
    • 开发版本 (从GitHub主分支): 
      uv pip install "airbyte-connector-builder-mcp @ git+https://github.com/airbytehq/connector-builder-mcp.git@main"
    • 本地开发版本: 
      # 首先克隆仓库
git clone https://github.com/airbytehq/connector-builder-mcp.git
cd connector-builder-mcp
# 然后使用 uv run 启动
uv run airbyte-connector-builder-mcp

服务器配置（供MCP客户端使用）

MCP客户端（如 Claude Desktop 或 VS Code MCP 扩展）需要配置本服务器的启动命令。以下是通用的配置信息，请根据您的客户端和安装方式选择。这些信息是给客户端的配置，而不是让您运行的代码：

  • 稳定版本:

    • 服务器名称: 'connector-builder-mcp--stable'
    • 启动命令: 'uvx'
    • 命令参数: 'airbyte-connector-builder-mcp'
    • 注释: 'uvx' 会自动查找并运行 'airbyte-connector-builder-mcp' 包中的可执行文件。

  • 开发版本 (main 分支):

    • 服务器名称: 'connector-builder-mcp--dev-main'
    • 启动命令: 'uvx'
    • 命令参数: '--from=git+https://github.com/airbytehq/connector-builder-mcp.git@main', 'airbyte-connector-builder-mcp'
    • 注释: 从 GitHub 主分支动态安装并运行 'airbyte-connector-builder-mcp'。

  • 本地开发版本:

    • 服务器名称: 'connector-builder-mcp--local-dev'
    • 启动命令: 'uv'
    • 命令参数: 'run', '--project', '/path/to/repos/connector-builder-mcp', 'airbyte-connector-builder-mcp'
    • 注释: 请将 '/path/to/repos/connector-builder-mcp' 替换为您的实际仓库路径，以在本地开发环境中运行。

  • VS Code用户: 可以直接使用仓库内 '.vscode/mcp.json' 提供的配置。

基本使用方法

MCP服务器通常不直接与人交互，而是由支持 MCP 协议的LLM客户端（如集成到AI助手中的工具调用接口）在后台自动调用。LLM客户端会通过 JSON-RPC 请求与此服务器通信，例如：

  • LLM 可能会调用 'create_connector_manifest_scaffold' 工具来生成一个新的连接器清单骨架。
  • LLM 可能会调用 'validate_manifest' 工具来检查某个连接器清单的结构是否有效。
  • LLM 可能会调用 'execute_stream_test_read' 工具来测试连接器从特定数据流读取数据的能力。
  • LLM 可能会调用 'populate_dotenv_missing_secrets_stubs' 来管理和填充敏感凭证。 您无需手动发送JSON-RPC请求，只需确保您的MCP客户端已正确配置并能够调用此服务器提供的工具。

信息

分类

开发者工具

访问项目