Yonote MCP Server

by cutalion
  • Linux
  • Apple

Integrations

  • Used for loading environment variables to configure the MCP server with authentication credentials and API endpoints for the Yonote service.

  • Provides API tools to interact with Yonote documents and collections, which is described as an alternative to Notion. Allows listing documents/collections, retrieving document details, and navigating the content hierarchy.

Yonote MCP 服务器原型

这是 Yonote 服务的 MCP(多渠道平台)服务器的 MVP 项目,该服务是 Notion 的替代方案。该服务器提供与 Yonote 文档和集合交互的 API 工具。

特征

  • 列出 Yonote 中的文档和收藏
  • 获取有关文档的详细信息
  • 通过 FastMCP 框架公开工具

要求

  • Python 3.13+
  • Yonote API 凭证
  • 以下 Python 包(参见pyproject.toml ):
    • fast-agent-mcp>=0.2.23
    • requests>=2.32.3
    • python-dotenv (用于加载环境变量)
  • uv用于依赖管理

设置

  1. 克隆存储库:
    git clone <your-repo-url> cd yonote-mcp
  2. 使用 uv 安装依赖项:
    uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .
  3. 配置环境变量:在项目根目录中创建一个.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 :通过 ID 获取文档信息
  • 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替换为项目目录的实际路径。

-
security - not tested
F
license - not found
-
quality - not tested

提供与 Yonote 文档和集合交互的 API 工具,作为 Notion 的替代品,具有列出文档/集合和检索详细文档信息的功能。

  1. 特征
    1. 要求
      1. 设置
        1. 用法
          1. 项目结构
            1. 执照
              1. 游标配置示例

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  Enables AI language models to interact with Microsoft OneNote via a standardized interface, supporting notebook and page management through natural language.
                  Last updated -
                  107
                  6
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  Facilitates initiating Ollama queries via Claude and manages a simple note storage system with capabilities to add, summarize, and access notes using custom URIs.
                  Last updated -
                  1
                  2
                  Python
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  Enables interaction with Curri's API by managing text notes, offering tools for note creation, and generating summaries using structured prompts.
                  Last updated -
                  JavaScript
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  Enables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
                  Last updated -
                  3
                  2
                  TypeScript
                  MIT License
                  • Apple

                View all related MCP servers

                ID: k9fg5wz6vl