MCP-сервер для AI OS

Предоставляет AI OS Феликса (синхронизированную в Notion) в виде MCP-инструментов, чтобы любой MCP-совместимый ИИ-клиент мог запрашивать её напрямую, а не парсить публичную ссылку.

Честное ограничение: это было написано без возможности реально выполнить npm install или проверить компиляцию (в среде, где он создавался, не было доступа к сети). Насколько известно, код корректно соответствует актуальным формам MCP TypeScript SDK и API клиента Notion, но выполните шаг сборки самостоятельно и проверьте на ошибки, прежде чем доверять ему, — не считайте его безупречным только потому, что он написан аккуратно.

Предоставляемые инструменты

• search_vault(query) — поиск по ключевым словам по всему AI OS

• get_page(page_name) — полное содержимое одной указанной страницы

• list_projects() — текущее содержимое индексной страницы 10_Projects

• get_project_status(project_name) — актуальный статус конкретного проекта

Related MCP server: nooon

Настройка

1. Создайте интеграцию Notion

Перейдите на notion.so/my-integrations → Новая интеграция → дайте ей имя (например, «AI OS MCP») → скопируйте «Internal Integration Secret» (начинается с secret_ или ntn_).

2. Предоставьте интеграции доступ к AI OS

Откройте корневую страницу AI OS в Notion → меню ... → Подключения → добавьте только что созданную интеграцию. Это отдельно от «Share to web» — именно это позволяет вызовам API интеграции видеть страницы.

3. Задайте ключ API

cp .env.example .env
# paste your key into .env

4. Соберите и запустите с Docker

docker compose build
docker compose run --rm ai-os-mcp

Это запускает сервер через stdio — он предназначен для запуска MCP-клиентом (Claude Desktop и т. п.), а не для постоянной работы в терминале в одиночку.

5. Укажите MCP-клиенту на этот сервер

Для Claude Desktop добавьте в его конфигурацию MCP (claude_desktop_config.json):

{
  "mcpServers": {
    "ai-os": {
      "command": "docker",
      "args": ["compose", "-f", "/full/path/to/ai-os-mcp/docker-compose.yml", "run", "--rm", "ai-os-mcp"]
    }
  }
}

Что стоит проверить, прежде чем доверять ему

• Успешно ли выполняется npm install, или есть несовпадения версий с SDK?

• Компилируется ли npm run build без ошибок?

• Возвращает ли search_vault реальные результаты — это зависит от того, предоставлен ли интеграции доступ к нужным страницам (шаг 2).

• Содержимое таблиц в get_page может отображаться приблизительно — блочный API Notion вложенный, а этот код вытаскивает строки таблиц на один уровень в глубину, глубже не проверено.

Чего это не делает

Никакой записи и редактирования — только чтение, поэтому он не может случайно изменить хранилище. Никакой автоматизации — его всё так же должен вызывать MCP-клиент по запросу, что согласуется с решением AI OS о «ручном, запускаемом из чата» выполнении.