Bruno API MCP 服务器

一个将 Bruno API 集合作为 MCP 工具暴露出来的 Model Context Protocol（MCP）服务器。此服务器允许您通过 MCP 协议与您的 Bruno API 集合交互，使您的 API 集合可供 AI 代理和其他 MCP 客户端使用。

为什么重要：源代码和数据协同工作

当开发人员需要集成第三方 API 时，通常会面临三个核心挑战：

1. 跨越系统边界的调试：在不同的代码和数据环境中诊断问题往往很困难。
2. API 请求的重复定义：每次调用都需要手动复制粘贴相同的 URL、标头和其他配置，效率低下。
3. 版本控制和依赖管理：随着 API 的变化和需求的调整，难以有效地跟踪和管理这些更改。

Bruno 解决了这些问题。通过将 API 请求存储在文件中，并为每个请求生成一个可重用的工具，Bruno 实现了代码与数据的分离。这样，您可以在团队内部轻松共享 API 请求，进行版本控制，并确保所有人都使用相同的配置和依赖关系。

功能

• 自动转换：将 Bruno 集合中的每个请求自动转换为 MCP 工具。
• 环境管理：支持不同的运行时环境（如开发、测试、生产），使您可以轻松切换变量和配置。
• 变量替换：在 URL、标头和请求正文中标量的变量，以便于定制请求。
• 查询参数：允许添加或覆盖查询参数，提供更多灵活性。
• 自定义主体参数：直接在请求正文中指定自定义参数。

使用方法

安装与运行

1. 安装 Bruno CLI：

   npm install -g bruno
   

2. 初始化项目：

   bruno init
   

3. 添加请求： 将 API 请求保存到 requests/ 文件夹中的 .bruno 文件中。
4. 生成工具：

   bruno generate
   

5. 调用工具： 使用 MCP 协议直接调用生成的工具。

示例

假设有一个请求文件 requests/get-user.bruno，内容如下：

{
  "url": "{{baseUrl}}/users/{{userId}}",
  "headers": {
    "Authorization": "Bearer {{apiKey}}"
  },
  "query": {
    "include": "posts"
  }
}

调用时，您可以通过 MCP 协议传递自定义变量：

{
  "environment": "dev",
  "variables": {
    "userId": "123",
    "apiKey": "your-api-key"
  }
}

预定义脚本

• 启动服务器：

  npm start
  

• 构建项目：

  npm run build
  

开发

贡献指南

1. 克隆仓库：

   git clone https://github.com/your-repo.git
   cd your-repo
   

2. 安装依赖项：

   npm install
   

3. 运行测试：

   npm test
   

工具列表

• 环境工具：bruno env
• 生成工具：bruno generate
• 调用工具：bruno call

使用 Custom Parameters with Tools（使用自定义参数与工具）

当调用由 Bruno API 集合生成的 MCP 工具时，您可以提供以下自定义配置：

环境覆盖

指定不同的环境以使用特定的变量设置：

{
  "environment": "prod"
}

变量替换

在 URL、标头和请求正文中替换变量：

{
  "variables": {
    "userId": "123",
    "apiKey": "test-key"
  }
}

查询参数

添加或覆盖查询参数：

{
  "query": {
    "page": 1,
    "per_page": 10
  }
}

自定义主体参数

在请求正文中标量自定义参数：

{
  "body": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}

完整示例

结合所有自定义选项的完整示例：

{
  "environment": "staging",
  "variables": {
    "dealId": "abc123",
    "apiKey": "test-key-staging"
  },
  "query": {
    "limit": 5,
    "sort": "created_at"
  },
  "body": {
    "status": "active",
    "amount": 100.5
  }
}

许可证

MIT License