Yonote MCP Server
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+
Die folgenden Python-Pakete (siehe
pyproject.toml):fast-agent-mcp>=0.2.23requests>=2.32.3python-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 claudeManuelle Installation
Klonen Sie das Repository:
git clone <your-repo-url> cd yonote-mcpInstallieren 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
.envDatei 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.pyDer 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 abrufencollections_list: Ruft eine Liste der Sammlungen ab (mit optionalem Limit und Offset)
Projektstruktur
main.py– Hauptservercode und Tooldefinitionenpyproject.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.

Available Tools
3 toolscollections_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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
Access and edit your Craft documents.
Share HTML/Markdown documents via URL instantly. Create, edit, delete docs from any AI tool.
Notes, kanban tasks, and a capture inbox: read and create Flow data with a personal token.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Yuque (语雀) knowledge base platform through their API. Supports document management, search, and repository operations including creating, reading, updating, and deleting documents in multiple formats.93MIT
- AlicenseNot gradedqualityFmaintenanceEnables interaction with SiYuan Note through its API for comprehensive note management. Supports searching, creating, editing documents, managing notebooks, and daily notes operations through natural language commands.15Apache 2.0
- AlicenseCqualityBmaintenanceEnables interaction with note.com through API to search and read articles, manage posts and drafts, handle comments and likes, retrieve analytics, and access membership information.3436 npm31ISC
- AlicenseBqualityDmaintenanceEnables access to Yuque (语雀) documentation through cookie-based authentication, supporting document retrieval, search, TOC navigation, and content management from knowledge bases via URL or namespace.44MIT