RunLoop MCP Server

RunLoop MCP Server

site icon
2025.03.11 0
TypeScript开发工具环境管理测试工具开发效率
RunLoop MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,旨在使 Claude Desktop 能够与 RunLoop 开发环境和工具进行交互。该服务器实现了 Anthropic 的 MCP 规范,允许 Claude Desktop 以编程方式创建和管理 RunLoop 的隔离开发环境(devboxes)、部署预配置环境、定义和执行测试场景、运行 AI 性能基准测试以及管理源代码仓库。
View on GitHub

Overview

基本能力

产品定位

RunLoop MCP Server 是一个开发工具,旨在为 Claude Desktop 提供与 RunLoop 开发环境和工具的无缝集成。

核心功能

  • 完整的编程访问:提供 Claude Desktop 对 RunLoop API 的完全访问权限。
  • 基于 Zod 的验证:使用由 orval 生成的模式来验证来自 Claude 的输入。
  • 基础设施管理:允许配置、管理和销毁 devboxes。
  • 蓝图部署:通过蓝图实现一致的环境设置。
  • 测试和基准测试工具:简化 AI 性能测试和基于场景的测试。

适用场景

  • 开发环境的自动化管理
  • AI 性能测试和基准测试
  • 源代码仓库的管理
  • 预配置环境的快速部署

工具列表

  • orval:从 OpenAPI 规范生成 Zod 模式。
  • Biome:确保代码风格一致并识别潜在问题。
  • Zod:在运行时验证 AI 输入。

常见问题解答

  • 调试问题:由于 MCP 服务器通过 stdin/stdout 通信,调试可能较为复杂。建议使用 MCP Inspector 工具进行实时监控和故障排除。

使用教程

使用依赖

  1. 克隆仓库
git clone https://github.com/IvanPedroza/runloop-mcp.git
cd runloop-mcp
  1. 安装依赖
npm install

安装教程

  1. 添加 Claude Desktop 配置
  2. macOS~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows%APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "runloop": {
      "command": "node",
      "args": ["<YOUR-PATH-HERE>/build/index.js"],
      "env": {
        "RUNLOOP_API_KEY": "API-KEY"
      }
    }
  }
}

调试方式

  1. 使用 MCP Inspector
npm run inspector
  • 该工具将在控制台中打印一个 URL,访问该 URL 可以实时监控日志和消息。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。