Прототип сервера 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 :

npx -y @smithery/cli install @cutalion/yonote-mcp --client claude

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

Клонируйте репозиторий:
```
git clone <your-repo-url>
cd yonote-mcp
```

Установите зависимости с помощью uv:

uv pip install -r requirements.txt
# or, using pyproject.toml:
uv pip install .

Настройте переменные среды:
Создайте в корне проекта файл .env со следующим содержимым:
```
API_TOKEN=your_yonote_api_token
API_BASE_URL=https://app.yonote.ru/api  # Optional, defaults to this value
```

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

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

python main.py

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

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

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

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

Лицензия

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

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

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

{
  "mcpServers": {
    "yonote": {
      "command": "uv",
      "args": [
        "run",
        "-v",
        "--directory",
        "/path/to/yonote-mcp",
        "/path/to/yonote-mcp/main.py"
      ]
    }
  }
}

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

Скриншот

Yonote MCP Server