Yonote MCP-Server-Prototyp

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.