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: mcp-discord-chat 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

Klonen Sie das Repository:
```
git clone <your-repo-url>
cd yonote-mcp
```

Installieren Sie Abhängigkeiten mit uv:

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

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