n8n-mcp

Um sistema simples de armazenamento de notas com ferramentas para adicionar e resumir notas usando um esquema de URI personalizado note://.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP n8n-mcp

Um projeto de servidor MCP.

Este projeto é uma adaptação em Python do projeto original em Node.js por kingler.

Componentes

Recursos

O servidor implementa um sistema simples de armazenamento de notas com:

  • Esquema de URI personalizado note:// para acessar notas individuais
  • Cada recurso de nota possui nome, descrição e mimetype text/plain

Prompts

O servidor fornece um único prompt:

  • summarize-notes: Cria resumos de todas as notas armazenadas
    • Argumento opcional "style" para controlar o nível de detalhe (brief/detailed)
    • Gera um prompt combinando todas as notas atuais com a preferência de estilo

Ferramentas

O servidor implementa uma ferramenta:

  • add-note: Adiciona uma nova nota ao servidor
    • Recebe "name" e "content" como argumentos de string obrigatórios
    • Atualiza o estado do servidor e notifica os clientes sobre mudanças nos recursos

Configuração

[TODO: Adicionar detalhes de configuração específicos da sua implementação]

Início Rápido

Instalação

Claude Desktop

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

Configuração de Servidores Não Publicados ``` "mcpServers": { "n8n-mcp": { "command": "uv", "args": [ "--directory", "(path_to_repo)/n8n-mcp", "run", "n8n-mcp" ] } } ```
Configuração de Servidores Publicados ``` "mcpServers": { "n8n-mcp": { "command": "uvx", "args": [ "n8n-mcp" ] } } ```

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

  1. Sincronize as dependências e atualize o lockfile:
uv sync
  1. Compile as distribuições do pacote:
uv build

Isso criará distribuições de origem e wheel no diretório dist/.

  1. Publique no PyPI:
uv publish

Observação: Você precisará definir as credenciais do PyPI por meio de variáveis de ambiente ou flags de comando:

  • Token: --token ou UV_PUBLISH_TOKEN
  • Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP operam via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

npx @modelcontextprotocol/inspector uv --directory /home/administrator/workspace/n8n_agent/n8n-mcp run n8n-mcp

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.