Руководство по настройке: MCP-сервер Fullscale Rocks

В этом руководстве объясняется, как установить, настроить и запустить MCP-сервер для базы данных fullscale-rocks.

1. Установка

Если вы еще этого не сделали, установите зависимости:

cd rocks-mcp
npm install

2. Конфигурация

Сервер требует учетные данные базы данных и открытый ключ OAuth.

Настройки базы данных

Создайте или отредактируйте rocks-mcp/.env:

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_DATABASE=employee
MYSQL_USER=employee
MYSQL_PASSWORD=thisisapassword

PG_HOST=127.0.0.1
PG_PORT=5432
PG_DATABASE=employee
PG_USER=employee
PG_PASSWORD=thisisapassword

SSE_PORT=3001

Аутентификация

Сервер автоматически ищет открытый ключ OAuth по адресу: /home/ryscript/fullscale-rocks/rocks-api/storage/oauth-public.key

Убедитесь, что этот файл существует, так как он используется для проверки JWT-токенов из rocks-api.

3. Запуск сервера

Режим разработки

Запуск сервера с помощью tsx (перезагрузка при изменениях в файлах):

npm run dev

Промышленный режим

Соберите код TypeScript и запустите собранную версию:

npm run build
npm start

4. Подключение к ИИ-приложениям

Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "rocks-db": {
      "command": "node",
      "args": ["/home/ryscript/fullscale-rocks/rocks-mcp/build/index.js"]
    }
  }
}

Универсальный MCP-клиент (SSE)

Сервер также поддерживает Server-Sent Events (SSE) для удаленных или веб-клиентов.

• URL SSE: http://localhost:3001/sse

• URL для отправки сообщений: http://localhost:3001/message

Вы можете использовать это с MCP Inspector или другими SSE-совместимыми клиентами.

5. Справочник инструментов

Сервер предоставляет следующие инструменты:

Примечание: auth_token должен быть действительным токеном Bearer, полученным в процессе входа в rocks-api.