使用说明

项目简介

Brev MCP 服务器是一个实现了 Model Context Protocol (MCP) 的服务器端应用，它作为 LLM 客户端和 Brev 云平台之间的桥梁。通过 MCP 协议，该服务器允许 LLM 应用访问 Brev 平台上的云资源信息（如各种云服务商的实例类型），并能调用工具来管理 Brev 工作空间，例如创建新的工作空间。

主要功能点

资源管理: 提供对 Brev 平台资源的标准化访问，目前主要提供各云服务商 (AWS, GCP, Azure, Crusoe 等) 的实例类型信息查询功能。
工具执行: 注册并提供工具供 LLM 客户端调用，目前包括：
- 'get_instance_types': 获取指定云服务商的可用实例类型列表。
- 'create_workspace': 基于指定的实例类型和云服务商，在 Brev 平台上创建新的工作空间。
MCP 协议支持: 完全遵循 Model Context Protocol 协议，确保与任何兼容 MCP 协议的 LLM 客户端无缝对接。

安装步骤

克隆仓库

git clone [email protected]:brevdev/brev-mcp.git

安装 uv 请根据 uv 安装指南安装 'uv' 包管理器。
进入仓库目录
```
cd brev-mcp
```
同步依赖
```
uv sync
```

服务器配置

要将 Brev MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加服务器配置信息。以下是 'claude_desktop_config.json' 文件的配置示例：

"mcpServers": {
  "brev_mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "<path-to-repo>",  // 将 "<path-to-repo>" 替换为您本地 brev-mcp 仓库的绝对路径
      "run",
      "brev-mcp"
    ]
  }
}

请将 '<path-to-repo>' 替换为您在本地克隆的 'brev-mcp' 仓库的实际绝对路径。

基本使用方法

配置完成后，MCP 客户端将能够连接到 Brev MCP 服务器。
客户端可以发送 MCP 请求来访问服务器提供的资源和工具。
资源访问: 客户端可以通过资源 URI (例如 'brev://instance-types/crusoe') 请求实例类型信息。
工具调用: 客户端可以调用已注册的工具 (例如 'get_instance_types', 'create_workspace') 来执行相应的 Brev 平台操作。
访问令牌刷新: 如果遇到 403 错误，通常是由于 Brev CLI 访问令牌过期。请在终端运行 'brev ls' 命令刷新访问令牌。

关键词