AI导哈

文档交互服务器

Yonote MCP服务器原型，提供API工具与Yonote文档和集合进行交互，作为Notion的替代方案。

  • by cutalion
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 cutalion/yonote-mcp

使用说明

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

相关 MCP