Notion

Gerencie e interaja com todo o seu espaço de trabalho do Notion.

Documentação

Navegue por todo o seu espaço de trabalho do Notion, não apenas por um banco de dados

MCP de navegação no Notion baseado em Markdown com apenas uma única variável ROOT_PAGE, eliminando a necessidade de um token.

Servidor MCP do Notion: notion-texonom
As páginas do Notion são convertidas em notas do tipo MIME text/markdown.
Pesquise e recupere páginas relevantes com base na distância do grafo, considerando relações pai-filho e de referência.

Um servidor Model Context Protocol (MCP) para gerenciar e interagir com notas baseadas no Notion. Este servidor baseado em TypeScript demonstra conceitos do MCP integrando recursos, ferramentas e prompts para interagir com páginas do Notion de forma eficiente.

Recursos

Resources

Acessar Notas: Liste e recupere páginas do Notion como URIs note:// com slugs UUID.
Metadados: Cada recurso inclui título, descrição e conteúdo em formato Markdown.
Tipos MIME: O conteúdo é acessível no formato text/markdown.

Ferramentas

Pesquisar Notas: Use a ferramenta search_notes para pesquisar páginas do Notion usando uma string de consulta.
- Entrada: Texto de consulta para filtrar páginas relevantes.
- Saída: Conteúdo em Markdown das notas correspondentes.

Prompts

Resumir Notas: Gere resumos para páginas individuais do Notion.
- Prompts disponíveis:
  - summarize_note: Resuma uma nota específica por URI.
  - suggest_refactor: Proponha melhorias estruturais.
  - suggest_fix: Identifique possíveis correções para o conteúdo da nota.
  - suggest_enhance: Recomende aprimoramentos para melhorar a nota.
- Entrada: URI da página do Notion.
- Saída: Mensagens estruturadas para resumo e aprimoramento.

Desenvolvimento

Configuração

Instale as dependências:

pnpm install

Compile o projeto:

pnpm build

Para desenvolvimento com recompilação automática:

pnpm watch

Configuração

Para configurar o servidor com o Notion:

Defina as variáveis de ambiente:
- ROOT_PAGE: O ID da página raiz do seu espaço de trabalho do Notion.

Instalação para o Claude Desktop

Para usar este servidor com o Claude Desktop, adicione a configuração:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Exemplo de configuração:

{
  "mcpServers": {
    "notion-texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

Depuração

Para solucionar problemas e depurar o servidor MCP, use o MCP Inspector. Para iniciar o Inspector, execute:

pnpm inspector

O Inspector fornece uma interface baseada em navegador para inspecionar a comunicação do servidor baseado em stdio.

Tecnologias Principais

Integração com o Notion: Alimentado por @texonom/nclient e @texonom/cli.
SDK MCP: Implementa @modelcontextprotocol/sdk para operações do servidor.

Implantação Remota

O servidor agora usa SSEServerTransport para comunicação remota, permitindo o uso compartilhado do servidor. Certifique-se de que as dependências necessárias estejam instaladas e que o servidor esteja configurado corretamente para implantação remota.

Instruções de Uso

Para executar o servidor com SSEServerTransport, use o seguinte comando:

npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"

Certifique-se de substituir /some/folder pelo caminho apropriado para sua pasta.