n8n-mcp
Un sistema simple de almacenamiento de notas con herramientas para agregar y resumir notas usando un esquema de URI personalizado note://.
Documentación
Servidor MCP n8n-mcp
Un proyecto de servidor MCP.
Este proyecto es una adaptación en Python del proyecto original en Node.js de kingler.
Componentes
Recursos
El servidor implementa un sistema simple de almacenamiento de notas con:
- Esquema de URI personalizado note:// para acceder a notas individuales
- Cada recurso de nota tiene un nombre, descripción y tipo MIME text/plain
Prompts
El servidor proporciona un único prompt:
- summarize-notes: Crea resúmenes de todas las notas almacenadas
- Argumento opcional "style" para controlar el nivel de detalle (brief/detailed)
- Genera un prompt que combina todas las notas actuales con la preferencia de estilo
Herramientas
El servidor implementa una herramienta:
- add-note: Añade una nueva nota al servidor
- Toma "name" y "content" como argumentos de cadena obligatorios
- Actualiza el estado del servidor y notifica a los clientes sobre cambios en los recursos
Configuración
[TODO: Añadir detalles de configuración específicos de tu implementación]
Inicio rápido
Instalación
Claude Desktop
En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json
Configuración de Servidores No Publicados
``` "mcpServers": { "n8n-mcp": { "command": "uv", "args": [ "--directory", "(path_to_repo)/n8n-mcp", "run", "n8n-mcp" ] } } ```Configuración de Servidores Publicados
``` "mcpServers": { "n8n-mcp": { "command": "uvx", "args": [ "n8n-mcp" ] } } ```Desarrollo
Compilación y Publicación
Para preparar el paquete para su distribución:
- Sincronizar dependencias y actualizar el archivo de bloqueo:
uv sync
- Compilar distribuciones del paquete:
uv build
Esto creará distribuciones de código fuente y wheel en el directorio dist/.
- Publicar en PyPI:
uv publish
Nota: Necesitarás establecer credenciales de PyPI mediante variables de entorno o banderas de comando:
- Token:
--tokenoUV_PUBLISH_TOKEN - O nombre de usuario/contraseña:
--username/UV_PUBLISH_USERNAMEy--password/UV_PUBLISH_PASSWORD
Depuración
Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para una mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.
Puedes lanzar el Inspector MCP mediante npm con este comando:
npx @modelcontextprotocol/inspector uv --directory /home/administrator/workspace/n8n_agent/n8n-mcp run n8n-mcp
Al lanzarlo, el Inspector mostrará una URL a la que puedes acceder en tu navegador para comenzar a depurar.