mcp notion

Notion MCP Server: notion-texonom

Noção baseada em Markdown Navegando MCP com apenas uma única variável ROOT_PAGE , eliminando a necessidade de um token.

• As páginas de noção são convertidas em notas de texto text/markdown .
• Pesquise e recupere páginas relevantes com base na distância do gráfico, considerando os relacionamentos entre pais e crianças e referência.

Um servidor de protocolo de contexto de modelo (MCP) para gerenciar e interagir com notas baseadas em noções. Este servidor baseado em digitação demonstra conceitos de MCP, integrando recursos, ferramentas e solicitações a interagir com as páginas de noção com eficiência.

Características

Recursos

• Notas de acesso : Liste e recupere as páginas de noção como note:// URIS com lesmas UUID.
• Metadados : Cada recurso inclui um título, descrição e conteúdo no formato Markdown.
• Tipos de MIME : O conteúdo é acessível no formato text/markdown .

Ferramentas

• Notas de pesquisa : use a ferramenta search_notes para pesquisar páginas de noção usando uma string de consulta.
  • Entrada: Texto de consulta para filtrar páginas relevantes.
  • Saída: conteúdo de marcação das notas correspondentes.

Avisos

• Resumir as Notas : Gere resumos para páginas de noção individual.
  • Prompts disponíveis:
    • summarize_note : Resuma uma nota específica por URI.
    • suggest_refactor : propor melhorias estruturais.
    • suggest_fix : identifique possíveis correções para o conteúdo da nota.
    • suggest_enhance : Recomende aprimoramentos para melhorar a nota.
  • Entrada: Página de noção URI.
  • Saída: mensagens estruturadas para resumo e aprimoramento.

Desenvolvimento

Configurar

Instale dependências:

pnpm install

Construa o projeto:

pnpm build

Para desenvolvimento com rebunda automática:

pnpm watch

Configuração

Para configurar o servidor com noção:

• Definir variáveis ​​de ambiente:
  • ROOT_PAGE : o ID da página raiz do seu espaço de trabalho de noção.

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 inspetor MCP. Para iniciar o inspetor, execute:

pnpm inspector

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

Tecnologias -chave

• Integração de noção: alimentado por @texonom/nclient e @texonom/cli.
• MCP SDK: implementos @modelcontextprotocol/sdk para operações do servidor.