Yonote

Protótipo do Servidor MCP Yonote

Este é um projeto MVP de um servidor MCP para o serviço Yonote, uma alternativa ao Notion. O servidor fornece ferramentas de API para interagir com documentos e coleções do Yonote.

Recursos

• Listar documentos e coleções do Yonote
• Obter informações detalhadas sobre um documento
• Expõe ferramentas por meio do framework FastMCP

Requisitos

• Python 3.13+
• Credenciais da API Yonote
• Os seguintes pacotes Python (veja pyproject.toml):
  • fast-agent-mcp>=0.2.23
  • requests>=2.32.3
  • python-dotenv (para carregar variáveis de ambiente)
• uv para gerenciamento de dependências

Configuração

Instalação via Smithery

Para instalar o Servidor de Interação com Documentos Yonote para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

1. Clone o repositório:

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

2. Instale as dependências usando uv:

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

3. Configure as variáveis de ambiente:

   Crie um arquivo .env na raiz do projeto com o seguinte conteúdo:

   API_TOKEN=your_yonote_api_token
   API_BASE_URL=https://app.yonote.ru/api  # Optional, defaults to this value
   

Uso

Execute o servidor MCP:

python main.py

O servidor expõe as seguintes ferramentas:

• documents_list: Obter uma lista de documentos (com limite, deslocamento e collectionId opcionais)
• documents_info: Obter informações sobre um documento por ID
• collections_list: Obter uma lista de coleções (com limite e deslocamento opcionais)

Estrutura do Projeto

• main.py — Código principal do servidor e definições de ferramentas
• pyproject.toml — Metadados do projeto e dependências

Licença

MIT (ou especifique sua licença)

Exemplo de Configuração do Cursor

Para usar este servidor MCP com o Cursor, adicione o seguinte ao seu arquivo de configuração ~/.cursor/mcp.json:

{
  "mcpServers": {
    "yonote": {
      "command": "uv",
      "args": [
        "run",
        "-v",
        "--directory",
        "/path/to/yonote-mcp",
        "/path/to/yonote-mcp/main.py"
      ]
    }
  }
}

Substitua /path/to/yonote-mcp pelo caminho real do diretório do seu projeto.