Yonote MCP Server

Yonote MCP服务器原型

这是Yonote服务的MCP服务器的MVP项目，是Notion的替代品。服务器提供API工具与Yonote文档和集合进行交互。

特性

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

需求

• Python 3.13+
• Yonote API证书
• 以下Python包（参见 pyproject.toml):

- fast-agent-mcp>=0.2.23 - requests>=2.32.3 - python-dotenv （用于加载环境变量）

• 紫外线 用于依赖关系管理

设置

通过Smithery安装

通过以下方式自动安装克劳德桌面版Yonote文档交互服务器 史密瑟里:

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

手动安装

1. 克隆存储库：

   git clone 
   cd yonote-mcp

1. 使用uv安装依赖项：

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

1. 配置环境变量：

创建一个 .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：获取文档列表（包括可选的限制、偏移和集合ID）
• 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 带有项目目录的实际路径。