Yonote MCP Server

Прототип сервера Yonote MCP

Это проект MVP сервера MCP (Multi-Channel Platform) для сервиса Yonote, альтернативы Notion. Сервер предоставляет инструменты API для взаимодействия с документами и коллекциями Yonote.

Функции

• Список документов и коллекций из Yonote
• Получить подробную информацию о документе
• Предоставляет инструменты через фреймворк FastMCP

Требования

• Питон 3.13+
• Учетные данные API Yonote
• Следующие пакеты Python (см. pyproject.toml ):
  • fast-agent-mcp>=0.2.23
  • requests>=2.32.3
  • python-dotenv (для загрузки переменных среды)
• uv для управления зависимостями

Настраивать

1. Клонируйте репозиторий:
   git clone <your-repo-url> cd yonote-mcp
2. Установите зависимости с помощью uv:
   uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .
3. Настройте переменные среды:Создайте в корне проекта файл .env со следующим содержимым:
   API_TOKEN=your_yonote_api_token API_BASE_URL=https://app.yonote.ru/api # Optional, defaults to this value

Использование

Запустите MCP-сервер:

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

• documents_list : Получить список документов (с необязательным лимитом, смещением и collectionId)
• documents_info : Получить информацию о документе по идентификатору
• collections_list : Получить список коллекций (с необязательным ограничением и смещением)

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

• main.py — Основной код сервера и определения инструментов
• pyproject.toml — метаданные и зависимости проекта

Лицензия

MIT (или укажите вашу лицензию)

Пример конфигурации курсора

Чтобы использовать этот сервер MCP с Cursor, добавьте следующее в файл конфигурации ~/.cursor/mcp.json :

Замените /path/to/yonote-mcp на фактический путь к каталогу вашего проекта.