{"id":31322762,"url":"https://github.com/backsoul/mcp-n8n","last_synced_at":"2026-05-08T07:32:08.874Z","repository":{"id":315230212,"uuid":"1058635272","full_name":"backsoul/mcp-n8n","owner":"backsoul","description":"Servidor MCP integrado con n8n y PostgreSQL para crear workflows inteligentes y herramientas personalizadas. Permite extender n8n con agentes AI y herramientas MCP, facilitando la automatización avanzada y la integración de modelos contextuales.","archived":false,"fork":false,"pushed_at":"2025-09-17T10:59:28.000Z","size":773,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-25T19:28:06.356Z","etag":null,"topics":["ai-agent","automation","docker","integration","mcp","n8n","postgres","tools","typescript","workflow-automation"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/backsoul.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-17T10:53:00.000Z","updated_at":"2025-09-21T04:07:54.000Z","dependencies_parsed_at":"2025-09-17T12:45:12.183Z","dependency_job_id":"77496a1b-b3e2-468c-842c-894b86282225","html_url":"https://github.com/backsoul/mcp-n8n","commit_stats":null,"previous_names":["backsoul/mcp-n8n"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/backsoul/mcp-n8n","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backsoul%2Fmcp-n8n","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backsoul%2Fmcp-n8n/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backsoul%2Fmcp-n8n/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backsoul%2Fmcp-n8n/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/backsoul","download_url":"https://codeload.github.com/backsoul/mcp-n8n/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backsoul%2Fmcp-n8n/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32770994,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T02:36:36.067Z","status":"ssl_error","status_checked_at":"2026-05-08T02:36:07.210Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","automation","docker","integration","mcp","n8n","postgres","tools","typescript","workflow-automation"],"created_at":"2025-09-25T19:13:08.731Z","updated_at":"2026-05-08T07:32:08.844Z","avatar_url":"https://github.com/backsoul.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mcp-server\n\nServidor Model Context Protocol (MCP) construido con mcp-framework.\n\n## 1. Instalación y ejecución\n\n1. Instala las dependencias:\n\n   ```bash\n   npm install\n   ```\n\n2. Compila el proyecto (esto es necesario cada vez que agregues o modifiques una tool):\n\n   ```bash\n   npm run build\n   ```\n\n3. Levanta los contenedores MCP, n8n y postgres (esto reconstruye la imagen y toma los cambios):\n\n```bash\ndocker-compose up mcp n8n postgres --build\n```\n\nEsto iniciará el servidor MCP, n8n y la base de datos postgres necesaria para n8n. Por defecto, n8n estará disponible en [http://localhost:5678](http://localhost:5678) en tu navegador.\n\nSi solo quieres levantar n8n y postgres (por ejemplo, para pruebas de integración):\n\n```bash\ndocker-compose up n8n postgres\n```\n\n\u003e **Nota:** El servicio de postgres es requerido por n8n para almacenar los datos de workflows, credenciales y ejecuciones.\n\n## 2. Crear una nueva Tool\n\nPuedes crear una nueva tool usando el CLI del framework MCP. Ejemplo:\n\n```bash\nmcp add tool mi-nueva-tool\n```\n\nEsto generará un archivo en `src/tools/`. Edita el archivo para definir la lógica de tu tool.\n\nEjemplo básico:\n\n```typescript\nimport { MCPTool } from \"mcp-framework\";\nimport { z } from \"zod\";\n\ninterface MiToolInput {\n  mensaje: string;\n}\n\nclass MiTool extends MCPTool\u003cMiToolInput\u003e {\n  name = \"mi_tool\";\n  description = \"Descripción de lo que hace tu tool\";\n  schema = {\n    mensaje: {\n      type: z.string(),\n      description: \"Mensaje de entrada\",\n    },\n  };\n  async execute(input: MiToolInput) {\n    return `Procesado: ${input.mensaje}`;\n  }\n}\n\nexport default MiTool;\n```\n\nRecuerda ejecutar `npm run build` y reiniciar el contenedor para que la nueva tool esté disponible.\n\n## 3. Integración con n8n\n\nPara conectar n8n con MCP, configura el nodo MCP Client en n8n con la URL de tu servidor MCP, por ejemplo:  \n`http://mcp:8080/mcp`\n\nAsegúrate de que el contenedor MCP esté corriendo y accesible desde n8n.\n\n### Ejemplo de configuración visual\n\n#### Configuración del Webhook en n8n\n\n![WebhookConfig](./WebHookConfig.png)\n\n#### Configuración del nodo AI Agent\n\n![AIAgentConfig](./AIAgentConfig.png)\n\n#### Configuración del nodo MCP Client\n\n![MCPClientConfig](./MCPClientConfig.png)\n\n#### Ejemplo de workflow completo\n\n![FullWorkFlow](./FullWorkFlow.png)\n\n## 4. Notas adicionales\n\n- Si agregas nuevas tools o modificas el código, siempre ejecuta `npm run build` antes de reiniciar el contenedor.\n- El contenedor MCP debe levantarse con el flag `--build` para tomar los cambios.\n- Las imágenes incluidas muestran ejemplos de configuración en n8n para facilitar la integración.\n\n- Para acceder a la interfaz de n8n, abre [http://localhost:5678](http://localhost:5678) en tu navegador.\n\n## 5. Recursos\n\n- [MCP Framework Github](https://github.com/QuantGeekDev/mcp-framework)\n- [MCP Framework Docs](https://mcp-framework.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbacksoul%2Fmcp-n8n","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbacksoul%2Fmcp-n8n","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbacksoul%2Fmcp-n8n/lists"}