BifrostMCP 项目启动与配置教程

1. 项目目录结构及介绍

BifrostMCP 是一个 VSCode 插件，它提供了一个 Model Context Protocol (MCP) 服务器，使得 VSCode 的强大开发工具和语言特性能够被 AI 工具使用。以下是项目的目录结构及其简单介绍：

• src/: 源代码目录，包含了插件的主要逻辑。
• .vscode/: VSCode 的配置文件目录。
• example.bifrost.config.json: 示例配置文件，用于展示如何配置项目。
• CHANGELOG.md: 更新日志文件，记录了项目的版本更新和变更历史。
• LICENSE: 许可证文件，本项目遵循 AGPL-3.0 许可证。
• README.md: 项目说明文件，包含了项目的介绍、功能、使用方法等信息。
• package.json: Node.js 项目配置文件，定义了项目的依赖、脚本等。
• tsconfig.json: TypeScript 配置文件，定义了项目的 TypeScript 编译选项。

2. 项目的启动文件介绍

项目的启动主要是通过运行 supergateway 命令来启动 MCP 服务器。以下是在不同操作系统上启动项目的方法：

Windows 启动命令

{
  "mcpServers": {
    "Bifrost": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "supergateway", "--sse", "http://localhost:8008/sse"],
      "disabled": false,
      "autoApprove": [],
      "timeout": 600
    }
  }
}

Mac/Linux 启动命令

{
  "mcpServers": {
    "Bifrost": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse", "http://localhost:8008/sse"],
      "disabled": false,
      "autoApprove": [],
      "timeout": 600
    }
  }
}

在上述配置中，supergateway 是项目的启动脚本，--sse 参数指定了服务器的 SSE 端点。

3. 项目的配置文件介绍

项目的配置文件主要用于定义项目的名称、描述、路径和端口等信息。配置文件为 bifrost.config.json，以下是一个示例配置：

{
  "projectName": "MyProject",
  "description": "Description of your project",
  "path": "/my-project",
  "port": 5642
}

在这个配置文件中：

• projectName: 定义了项目的名称。
• description: 提供了项目的描述。
• path: 指定了项目在文件系统中的路径。
• port: 定义了项目服务器将使用的端口。

每个项目应该有一个唯一的端口，以避免在运行多个 VSCode 实例时发生冲突。如果未指定端口，默认使用 8008。如果端口已被占用，需要释放端口或更改配置中的端口。