고릴라(Gorela) 개발자 사이트 MCP 서버

고릴라（Gorela）开发者网站 MCP 服务

本项目是使用 Model Context Protocol 实现的 MCP 服务（MCP Server），可将 고릴라（Gorela）API 文档作为上下文提供给 AI 模型。

고릴라（Gorela）是 바로고（BAROGO）提供的配送中介平台，提供连接订单合作伙伴与配送代理公司的 API。

支持在 Cursor AI IDE 等 MCP 宿主环境中，让 AI 理解并回答有关 고릴라 API 的问题。

目录

• 功能
• 要求
• 安装
• 构建
• 运行
• 与 Cursor AI IDE 集成
• 故障排除

功能

此 MCP 服务提供以下功能：

• 安全获取请求路径对应的 고릴라 API 文档，并将其作为上下文提供给 AI 模型

要求

• Node.js 18.0.0 或更高版本

安装

安装依赖包：

npm install

构建

npm run build

运行

运行 npm 仓库中发布的版本（推荐）

npm 仓库中发布的版本无需安装即可直接运行：

npx gorela-developer-mcp-server

运行本地构建版本

运行本地构建的版本：

npm start

运行后，可在项目根目录下的 logs/mcp-server.log 文件中查看日志。无论运行环境如何，日志始终保存在项目根目录下。

以开发模式运行：

npm run dev

与 Cursor AI IDE 集成

此 MCP 服务可连接到 Cursor AI IDE（MCP Host），让 AI 模型将 고릴라 API 文档用作上下文。

1. 配置 Cursor AI

可通过 Cursor AI IDE 的 Settings 菜单注册 MCP 服务。

重要：只需进行配置，无需由用户单独启动服务。Cursor IDE 会在需要时自动启动服务。

配置步骤：

1. 在 Cursor AI IDE 中打开 Settings 菜单。
2. 找到“MCP”部分。
3. 点击“Add new global MCP server”按钮。
4. 随后会打开 ~/.cursor/mcp.json 文件。

在此文件中添加如下 고릴라 MCP 服务信息：

方法 1：使用 npx（推荐）

{
  "mcpServers": {
    "gorela-api-docs": {
      "name": "Gorela Developer Site MCP",
      "type": "stdio",
      "command": "npx",
      "args": ["gorela-developer-mcp-server"]
    }
  }
}

方法 2：指定直接路径

使用此方法前，必须先安装并构建项目：

# 프로젝트 디렉토리로 이동
cd /실제경로/gorela-developer-mcp-server

# 필요한 패키지 설치
npm install

# 프로젝트 빌드
npm run build

然后，在 Cursor 的 MCP 配置中添加以下内容：

{
  "mcpServers": {
    "gorela-api-docs": {
      "name": "Gorela Developer Site MCP",
      "type": "stdio",
      "command": "node",
      "args": ["/실제경로/gorela-developer-mcp-server/dist/index.js"]
    }
  }
}

重要：使用方法 2 时，必须将 /实际路径 部分替换为项目的实际路径。例如，在 macOS 上，路径可能类似于 /Users/用户名/Projects/gorela-developer-mcp-server/dist/index.js。

Windows 上的路径可能有所不同，并且必须使用斜杠（/），而非反斜杠（\）。例如：C:/Users/用户名/Projects/gorela-developer-mcp-server/dist/index.js

保存文件后，重启 Cursor IDE，即可注册 MCP 服务。

注意：如果配置文件为空，请按照上述格式编写完整内容；如果已经注册了其他 MCP 服务，请将其添加到 mcpServers 对象中。

2. 在 Cursor AI 中使用

配置好 MCP 服务后，可在 Cursor AI 的聊天界面中这样使用：

/mcp 고릴라 연동에 필요한 api를 간단히 숙지해주세요.

고릴라 api 호출 헤더를 어떻게 설정해야 하나요?

주문 접수 api 유형에 대해 알려주세요.

주문 접수시 고정 요금, 유연 요금, 의무 수행, 자율 수행, 주소 기반, 상점 기반에 대한 차이점을 알려주세요.

예약 주문 접수시 유의사항에 대해 알려주세요.

주문 조회 api 테스트 코드를 작성해주세요.

3. 集成优势

将 Cursor AI 与 MCP 服务集成，可带来以下优势：

• 开发者无需离开 IDE，即可访问 고릴라 API 文档。
• 借助 AI，更轻松地理解和使用 API 文档内容。
• 通过自然语言提问고릴라 API，快速获得解答和代码示例。
• 提高开发效率，缩短 고릴라 集成所需时间。

4. 查看日志

MCP 服务会将所有操作记录到项目根目录下的 logs/mcp-server.log 文件中。服务启动时，启动日志中会记录日志文件的准确路径。需要检查服务运行情况或排查问题时，请查看此日志文件。日志文件包含以下信息：

• 服务启动和连接信息
• API 文档请求和响应
• 错误情况和警告消息
• 安全相关事件（例如：尝试访问上级目录）

故障排除

MCP 服务无法加载时

1. 确认已重启 Cursor IDE。
2. 确认 ~/.cursor/mcp.json 文件中的路径和命令正确无误。
3. 查看日志文件，查明错误消息。
4. 使用 npx 命令时，确认网络连接正常。

Node.js 环境相关问题

可能会遇到以下环境配置问题：

# Node.js 버전 확인
node --version

# TypeScript 관련 패키지가 설치되어 있는지 확인
npm list typescript ts-node

• 建议使用 Node.js 18 或更高版本。
• 如果缺少所需的软件包，请运行 npm install。
• 如果出现 TypeScript 编译错误，请查看日志并修改相应文件。

找不到文档时

API 文档 URL 路径可能已更改，也可能存在网络连接问题：

1. 确认网络连接正常。
2. 查看日志文件中的相关错误消息。
3. 访问开发者网站，确认文档是否存在。

MCP 服务无响应时

1. 确认是否有正在运行的 MCP 服务进程。
2. 查看日志文件中的错误或超时消息。
3. 确认系统资源（内存、CPU）使用情况是否正常。