Skip to main content
Glama
Yonote MCP Server

Yonote MCP Server

by cutalion

Yonote MCP-Server-Prototyp

Schmiedeabzeichen

Dies ist ein MVP-Projekt eines MCP-Servers für den Yonote-Dienst, eine Alternative zu Notion. Der Server bietet API-Tools für die Interaktion mit Yonote-Dokumenten und -Sammlungen.

Merkmale

  • Dokumente und Sammlungen von Yonote auflisten

  • Erhalten Sie detaillierte Informationen zu einem Dokument

  • Stellt Tools über das FastMCP-Framework bereit

Related MCP server: SiYuan MCP Server

Anforderungen

  • Python 3.13+

  • Yonote-API-Anmeldeinformationen

  • Die folgenden Python-Pakete (siehe pyproject.toml ):

    • fast-agent-mcp>=0.2.23

    • requests>=2.32.3

    • python-dotenv (zum Laden von Umgebungsvariablen)

  • UV für das Abhängigkeitsmanagement

Aufstellen

Installation über Smithery

So installieren Sie Yonote Document Interaction Server für Claude Desktop automatisch über Smithery :

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

Manuelle Installation

  1. Klonen Sie das Repository:

    git clone <your-repo-url>
    cd yonote-mcp
  2. Installieren Sie Abhängigkeiten mit uv:

    uv pip install -r requirements.txt
    # or, using pyproject.toml:
    uv pip install .
  3. Konfigurieren Sie Umgebungsvariablen:

    Erstellen Sie im Projektstammverzeichnis eine .env Datei mit folgendem Inhalt:

    API_TOKEN=your_yonote_api_token
    API_BASE_URL=https://app.yonote.ru/api  # Optional, defaults to this value

Verwendung

Führen Sie den MCP-Server aus:

python main.py

Der Server stellt die folgenden Tools bereit:

  • documents_list : Ruft eine Liste von Dokumenten ab (mit optionalem Limit, Offset und CollectionId).

  • documents_info : Informationen zu einem Dokument nach ID abrufen

  • collections_list : Ruft eine Liste der Sammlungen ab (mit optionalem Limit und Offset)

Projektstruktur

  • main.py – Hauptservercode und Tooldefinitionen

  • pyproject.toml – Projektmetadaten und Abhängigkeiten

Lizenz

MIT (oder geben Sie Ihre Lizenz an)

Beispiel für eine Cursorkonfiguration

Um diesen MCP-Server mit Cursor zu verwenden, fügen Sie Ihrer Konfigurationsdatei ~/.cursor/mcp.json Folgendes hinzu:

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

Ersetzen Sie /path/to/yonote-mcp durch den tatsächlichen Pfad zu Ihrem Projektverzeichnis.

Screenshot

Available Tools

3 tools
collections_listC

Get list of collections

Inputs: limit, offset.

documents_infoC

Get info about a document by id

Inputs: id (required).

documents_listC

Get list of documents

Inputs: limit, offset, collectionId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: collections_list retrieves collections, documents_info gets details of a specific document, and documents_list lists documents. There is no overlap in functionality, making it easy for an agent to select the right tool without confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case: collections_list, documents_info, and documents_list. The naming is predictable and readable throughout, with no deviations or mixed conventions.

    Tool Count3/5

    With only 3 tools, the server feels thin for a note-taking domain, as it lacks essential operations like creating, updating, or deleting collections or documents. While the tools are well-scoped individually, the count is borderline low for covering basic CRUD workflows.

    Completeness2/5

    The tool surface is significantly incomplete for a note-taking server. It only provides read operations (list and get info) for collections and documents, with no ability to create, update, or delete resources. This will likely cause agent failures when trying to perform common tasks like adding or modifying notes.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers