Outline MCP Server
Сервер для интеграции AI-агентов с платформой Outline через протокол MCP (Model Context Protocol). Позволяет программам управлять документами, коллекциями, комментариями и пользователями напрямую через API Outline.
Возможности
Управление документами
- Создание документов с кастомными параметрами
- Чтение, обновление и удаление существующих документов
- Поиск и фильтрация документов
- Запросы к документам на естественном языке
- Создание шаблонов из готовых документов
- Перемещение документов между коллекциями
- Архивация документов
Управление коллекциями
- Получение информации о коллекции
- Создание и обновление коллекций
- Список коллекций рабочего пространства
Управление комментариями
- Создание комментариев в документах
- Редактирование и удаление комментариев
Управление пользователями
- Фильтрация и просмотр списка пользователей
Быстрый старт
Требования
- Node.js v18+
- Аккаунт Outline с доступом к API
- API-ключ Outline с необходимыми правами
Установка и запуск
# Запуск через npx (без установки)
OUTLINE_API_KEY=ваш_ключ npx outline-mcp-server
# Или глобальная установка из npm
npm install -g outline-mcp-server
OUTLINE_API_KEY=ваш_ключ outline-mcp-server
# Запуск на другом порту (по умолчанию 6060)
OUTLINE_API_KEY=ваш_ключ outline-mcp-server --port 7070
Настройка среды
| Переменная |
Описание |
OUTLINE_API_KEY |
(обязательно) Ваш API-ключ Outline |
OUTLINE_API_URL |
(опционально) Альтернативный URL API (для кастомного домена или self-hosted версии). По умолчанию https://app.getoutline.com/api |
Использование
После запуска сервер подключается к AI-ассистентам, поддерживающим MCP (например, Claude через Cursor).
Примеры запросов к ассистенту:
- «Покажи список всех документов в моём Outline»
- «Создай новый документ в коллекции 'Продукты'»
- «Найди все документы по теме «онбординг»
- «Какой план проекта описан в документах?» (запрос на естественном языке)
- «Сделай шаблон из документа 'Отчёт'»
- «Обнови содержимое документа с ID 123»
- «Добавь комментарий к документу 'Регламент'»
Разработка
# Клонирование репозитория
git clone https://github.com/mmmeff/outline-mcp.git
cd outline-mcp
# Установка зависимостей
npm install
# Создание файла .env
# OUTLINE_API_KEY=ваш_ключ
# OUTLINE_API_URL=https://ваш-экземпляр.outline.com/api
# Запуск в режиме разработки с инспектором MCP
npm run dev
Важные замечания
- Для стабильного соединения с интеграцией Cursor рекомендуется SSE-реализация через Supergateway
- Все коммиты должны следовать спецификации Conventional Commits, так как проект использует semantic-release для автоматической публикации версий
- Релизы публикуются автоматически через GitHub Actions при пуше в ветку master: запускаются тесты, определяется номер версии, создаётся GitHub-релиз и пакет публикуется в npm
- Подробное руководство по контрибьюции — в CONTRIBUTING.md
Лицензия
MIT
Комментарии
Комментариев пока нет. Будьте первым.