Yonote MCP Server 原型

这是一个为 Yonote 服务（Notion 的替代品）设计的 MCP 服务器 MVP 项目。该服务器提供了与 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 用于依赖管理

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Yonote 文档交互服务器到 Claude Desktop：

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

手动安装

1. 克隆仓库：

   git clone <your-repo-url>
   cd yonote-mcp
   

2. 使用 uv 安装依赖：

   uv pip install -r requirements.txt
   # 或者，使用 pyproject.toml：
   uv pip install .
   

3. 配置环境变量：

   在项目根目录创建一个 .env 文件，内容如下：

   API_TOKEN=your_yonote_api_token
   API_BASE_URL=https://app.yonote.ru/api  # 可选，默认为此值
   

使用方法

运行 MCP 服务器：

python main.py

该服务器暴露了以下工具：

• documents_list：获取文档列表（可选参数包括限制、偏移量和集合ID）
• documents_info：通过ID获取文档信息
• collections_list：获取集合列表（可选参数包括限制和偏移量）

项目结构

• main.py — 主服务器代码和工具定义
• pyproject.toml — 项目元数据和依赖

许可证

MIT（或指定你的许可证）

Cursor 配置示例

要在 Cursor 中使用此 MCP 服务器，请在你的 ~/.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 替换为你项目的实际路径。