Slima MCP

MCP (Model Context Protocol) сервер для Slima — AI-среды для написания романов для авторов.

Подключите свои книги Slima к любому MCP-совместимому AI-инструменту — один сервер, все платформы.

Поддерживаемые платформы

Десктопные приложения (Локальный MCP — stdio)

Веб-приложения (Удаленный MCP — HTTP)

MCP стал отраслевым стандартом в декабре 2025 года, когда Anthropic, OpenAI и Block стали сооснователями Agentic AI Foundation под эгидой Linux Foundation.

Related MCP server: scrumdo-mcp

Возможности

Управление книгами

• Создание новых книг

• Список и просмотр ваших книг

• Получение структуры файлов/папок

• Отслеживание статистики написания

Операции с файлами

• Чтение любого файла по пути

• Редактирование конкретного текста (поиск и замена)

• Запись (замена) содержимого файла

• Создание новых файлов

• Удаление файлов

• Добавление содержимого в конец файла

• Поиск по всем файлам

AI-бета-читатель

• Получение обратной связи от виртуальных читательских персонажей

• Анализ глав с разных точек зрения читателей

Быстрый старт

Выберите путь, который соответствует вашему способу использования AI:

• ⭐ Используете claude.ai / ChatGPT в веб-браузере → Рекомендуется: веб-коннектор (однократная настройка, автообновление навсегда)

• Используете Claude Desktop / Cursor / Gemini CLI локально → Локальная установка с помощью npx

• Работаете в изолированных / корпоративных средах → Самостоятельный хостинг

Рекомендуется: claude.ai / ChatGPT Web (автообновление)

Если вы общаетесь с Claude или ChatGPT в браузере, это самый простой и перспективный вариант. Настройте один раз, и вы будете автоматически получать все обновления Slima MCP — никаких команд обновления, никаких правок конфигурации.

MCP URL: https://mcp.slima.ai/mcp

claude.ai (Pro / Max / Team / Enterprise)

1. Войдите в аккаунт на claude.ai.

2. Откройте Настройки → Connectors (или Integrations в зависимости от вашего тарифа).

3. Нажмите Add custom connector.

4. Заполните:

   • Name: Slima

   • URL: https://mcp.slima.ai/mcp

5. Нажмите Connect → вы будете перенаправлены на slima.ai для подтверждения → вернитесь на claude.ai.

6. В поле ввода чата появится значок инструментов Slima. Готово.

ChatGPT (Plus / Pro, Режим разработчика)

1. Войдите в аккаунт на chatgpt.com.

2. Откройте Настройки → Connectors → Advanced и включите переключатель Developer Mode (2025.10+).

3. Вернитесь в Connectors, нажмите Create → Custom MCP Server.

4. Заполните:

   • Name: Slima

   • Server URL: https://mcp.slima.ai/mcp

   • Authentication: OAuth

5. Нажмите Create → подтвердите OAuth-поток.

После настройки функции Slima автоматически появятся в вашем следующем разговоре. Никаких перезапусков, никаких переустановок.

Локально: Claude Desktop / Cursor / Gemini CLI

Используйте это, если вам нужна работа в офлайн-режиме, более быстрый запуск, или если вы хотите запускать MCP вместе с другими stdio-серверами.

Рекомендуемая конфигурация — привязана к мажорной версии, так что вы автоматически получаете новые функции, но не сломаетесь на релизе 1.0:

Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": {
        "SLIMA_API_TOKEN": "slima_your_token_here"
      }
    }
  }
}

Получите токен в Настройках Slima или выполните npx slima-mcp@0 auth один раз, чтобы сохранить его на диск.

Cursor

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": {
        "SLIMA_API_TOKEN": "slima_your_token_here"
      }
    }
  }
}

Gemini CLI

gemini mcp add slima --command "npx -y slima-mcp@0"

Почему slima-mcp@0 вместо slima-mcp / slima-mcp@latest? Использование @0 привязывает к текущей мажорной версии — npx всё равно будет автоматически получать новые 0.x.y релизы (так что вы получаете функции + исправления ошибок), но когда мы выпустим 1.0.0 с критическими изменениями, вы не получите их молча без обновления конфигурации. Мы объявим о переходе на @1 в примечаниях к релизу.

Миграция с глобальной установки

Если вы уже установили глобально с помощью npm install -g slima-mcp:

# Remove the old global install (optional but cleaner)
npm uninstall -g slima-mcp

# Change your config `command` from "slima-mcp" to the npx form above, and restart the client.

Или, если вы хотите остаться на глобальной установке, не забывайте периодически выполнять:

npm install -g slima-mcp@latest

Иначе ваш локальный клиент будет расходиться с инструментами/схемой MCP, которые предоставляет бэкенд Slima.

Самостоятельный хостинг (продвинутый)

Вы также можете клонировать этот репозиторий и развернуть Cloudflare Worker самостоятельно. См. wrangler.toml + npm run deploy:worker. Не требуется для обычного использования.

Безопасность удаленного MCP

Размещенный удаленный MCP-сервер по адресу https://mcp.slima.ai/mcp использует:

• OAuth 2.0 + PKCE для аутентификации — никаких копирований токенов.

• Никаких секретов, хранящихся на сервере — учетные данные никогда не покидают сервер аутентификации Slima.

• Сессионный подход: токены OAuth хранятся в Cloudflare KV с привязкой к сессии.

• Можно отозвать в любое время из Настроек Slima.

Типы книг: Writing Studio vs Script Studio

Книги Slima бывают двух типов, различающихся полем book_type. MCP ведет себя немного по-разному для каждого:

Для детальной информации по каждой книге попросите вашего AI-клиента прочитать ресурс slima://books/{book_token}/schema — он возвращает JSON-спецификацию, какие именно пути доступны для записи/только для чтения для этой конкретной книги.

list_books помечает каждую книгу значком студии (📝 / 📖), чтобы вы (и AI) могли легко их различать.

Доступные инструменты

Управление книгами

Операции с файлами

AI-бета-читатель

Примеры использования

После настройки вы можете попросить ваш AI:

Книги и содержимое:

• "Создай новую книгу под названием 'Мой роман'"

• "Покажи список моих книг в Slima"

• "Покажи структуру моего романа"

• "Прочитай главу 3 моей книги"

• "Какая у меня статистика написания?"

Операции с файлами:

• "Прочитай профиль персонажа моего главного героя"

• "Отредактируй главу 1, заменив 'Иван' на 'Джеймс'"

• "Создай новый файл worldbuilding.md с заметками о магической системе"

• "Найди все упоминания 'голубых глаз' в моей книге"

• "Добавь этот новый абзац в конец главы 5"

Обратная связь AI:

• "Получи отзыв на главу 5 с точки зрения молодого читателя"

• "Проанализируй мою первую сцену с точки зрения критика"

Команды CLI

slima-mcp auth      # Authenticate with browser (recommended)
slima-mcp status    # Check authentication status
slima-mcp logout    # Remove saved credentials
slima-mcp --help    # Show help
slima-mcp --version # Show version

Токен сохраняется в ~/.slima/credentials.json с безопасными правами доступа.

Переменные окружения

*Не обязательна, если вы использовали slima-mcp auth

Разработка

Локальная разработка CLI

# Clone the repository
git clone https://github.com/slima-ai/slima-mcp.git
cd slima-mcp

# Install dependencies
npm install

# Build CLI
npm run build

# Run tests
npm test

# Run in development mode
npm run dev

Разработка Cloudflare Worker

# Build the Worker
npm run build:worker

# Run Worker locally
npm run dev:worker

# Deploy to Cloudflare
npm run deploy:worker

# Deploy to preview environment
npm run deploy:worker:preview

Структура проекта

slima-mcp/
├── src/
│   ├── core/           # Shared core modules
│   │   ├── api/        # Slima API Client
│   │   ├── tools/      # MCP Tool implementations
│   │   └── utils/      # Utilities and errors
│   ├── cli/            # CLI entry point (stdio transport)
│   │   ├── index.ts    # CLI main
│   │   ├── auth.ts     # Authentication commands
│   │   └── server.ts   # MCP Server for CLI
│   └── worker/         # Cloudflare Worker (HTTP transport)
│       ├── index.ts    # Worker entry point
│       └── oauth.ts    # OAuth 2.0 + PKCE client
├── wrangler.toml       # Cloudflare Worker config
├── tsup.config.ts      # CLI build config
└── tsup.worker.config.ts # Worker build config

Безопасность

• API-токены хранятся локально и никогда не передаются

• Вся связь с API Slima использует HTTPS

• Токены можно отозвать в любое время в настройках Slima

Релиз и развертывание

npm (Автоматически)

Merge в ветку main с повышением версии в package.json запускает автоматическую публикацию в npm через GitHub Actions.

# 1. Bump version on dev branch
npm version patch   # 0.1.10 → 0.1.11

# 2. Merge to main
git checkout main && git merge dev && git push

# 3. CI runs tests → publish.yml publishes to npm + creates git tag

Cloudflare Worker (Вручную)

Развертывание Worker происходит отдельно от npm. Выполните развертывание после изменений кода:

npm run deploy:worker           # Production (mcp.slima.ai)
npm run deploy:worker:preview   # Staging

MCP Registry (Вручную)

Чтобы опубликовать/обновить список серверов в MCP Registry:

mcp-publisher login github
mcp-publisher publish

Требуется наличие mcpName в package.json и server.json в корне репозитория.

Эксплуатационные заметки

Отладка Worker OAuth

При устранении неполадок с коннектором claude.ai или ChatGPT:

# Live logs from production Worker
wrangler tail slima-mcp

Все OAuth-эндпоинты логируют ключевые параметры (client_id, redirect_uri, префикс токена и т.д.), чтобы помочь отследить поток.

Поток OAuth Worker (claude.ai / ChatGPT)

Client POST /mcp → 401 + WWW-Authenticate header
  → Client GET /.well-known/oauth-protected-resource
  → Client GET /.well-known/oauth-authorization-server
  → Client POST /register (DCR)
  → Client redirects user to GET /authorize
    → Worker redirects to Rails OAuth
    → User authorizes → Rails redirects to Worker /callback
    → Worker issues auth code → redirects to client callback
  → Client POST /token (exchange code for access_token)
  → Client POST /mcp (Authorization: Bearer {access_token})

Известные ограничения

• Worker Bearer token validation принимает все непустые токены (не только префикс slima_) для поддержки токенов, выданных OAuth. Rails API выполняет фактическую проверку.

• getTokenFromSession() проверяет заголовок Authorization в первую очередь, затем возвращается к cookie-сессии.

• MCP Inspector (npx @modelcontextprotocol/inspector) полезен для независимого тестирования полного потока OAuth.

Лицензия

MIT

Ссылки

• Веб-сайт Slima

• Приложение Slima

• Документация MCP

• Реестр MCP

• Сообщить об ошибках