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

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

Функции

• Список документов и коллекций из Yonote

• Получить подробную информацию о документе

• Предоставляет инструменты через фреймворк FastMCP

Related MCP server: mcp-discord-chat MCP server

Требования

• Питон 3.13+

• Учетные данные API Yonote

• Следующие пакеты Python (см. pyproject.toml ):

  • fast-agent-mcp>=0.2.23

  • requests>=2.32.3

  • python-dotenv (для загрузки переменных среды)

• uv для управления зависимостями

Настраивать

Установка через Smithery

Чтобы автоматически установить Yonote Document Interaction Server для Claude Desktop через Smithery :

Ручная установка

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 на фактический путь к каталогу вашего проекта.