Skip to content
Back to search

project-nova

A multi-agent AI architecture that connects 25+ specialized agents through n8n and MCP servers. Project NOVA routes requests to domain-specific experts, enabling control of applications from knowledge bases to DAWs, home automation to development tools. Includes system prompts, Dockerfiles, and workflows for a complete AI assistant ecosystem.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dujonwalker/project-nova with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dujonwalker/project-nova'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dujonwalker--project-nova/badge.svg)](/listings/dujonwalker--project-nova)

HTML

<a href="/listings/dujonwalker--project-nova"><img src="/api/listings/dujonwalker--project-nova/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

Before setting up Project NOVA, ensure you have:

Option A: OpenWebUI + n8n Setup (Recommended)

- **OpenWebUI Instance**: For the modern chat interface with conversation management - **Note**: For text-to-speech features (voice input), OpenWebUI requires SSL/HTTPS (even a self-signed certificate works) - **n8n Instance**: A running n8n installation (v1.88.0 or later) - **Critical**: Version 1.88.0+ is required as it introduced the native MCP Client Tool node - **No Community Nodes Required**: All agents now use n8n's native MCP Client Tool node

Option B: n8n Only Setup (Basic)

- **n8n Instance**: A running n8n installation (v1.88.0 or later) with chat trigger capabilities - **No Community Nodes Required**: All agents use n8n's native MCP Client Tool node

Common Requirements

- **Docker Host**: Environment for running containerized MCP servers - **LLM Access**: Either: - Cloud API access (OpenAI, Claude, Gemini, etc.) - Local Ollama instance with models that support tool use/function calling - **Applications to Control**: - The actual applications you want NOVA to control (most agents are designed for self-hosted applications) - Examples: Home Assistant, Gitea, Reaper, OBS Studio, TriliumNext, etc. - Each agent requires its corresponding application to be accessible

Setup Instructions

1. Clone the Repository

git clone https://github.com/dujonwalker/project-nova.git
cd project-nova

2. Choose Your Deployment Option

**Option A: OpenWebUI + n8n (Recommended)**

This setup provides the best user experience with conversation history, session management, and a modern interface.

1. **Set up OpenWebUI inlet filter**: - In your OpenWebUI instance, navigate to **Workspace** → **Functions** - Click **"Create New Function"** - Copy and paste the code from `openwebui-function/n8n_inlet_filter.py` into the function editor - **Important**: Update the `n8n_url` configuration variable at the top of the filter with your complete n8n webhook URL (including server IP/hostname and webhook UUID) - Save the filter

2. **Create a new model using the filter**: - Navigate to **Workspace** → **Models** - Click **"Create New Model"** - Configure your base model (e.g., your preferred LLM) - In the **Filters** section, select the n8n inlet filter you just created - Save the model - The filter will now automatically forward messages to n8n and manage conversation history

3. **Configure n8n workflows**: - Import the router agent workflow (`n8n-workflows/router_agent.json`) - Set up a webhook trigger in the router agent (configure URL in OpenWebUI filter) - Import specialized agent workflows as needed

**Option B: n8n Only Setup**

1. **Import workflows in your n8n instance**: - **Bulk import via n8n CLI** (easiest): ```bash # Navigate to your n8n installation directory n8n import:workflow --input=path/to/project-nova/n8n-workflows/* ``` - **Import via n8n Web Interface**: - Navigate to your n8n dashboard - Click on "Workflows" in the sidebar - Use the "Import from file" option for each workflow - Start with the router agent first, then specialized agents

2. **Configure after import**: - **Update OpenWebUI filter**: Copy the webhook URL from your imported router agent and paste it into the OpenWebUI inlet filter configuration - **Configure API keys**: Add your actual API keys for the services you want to use (Blinko, Home Assistant, etc.) - **Update server IPs**: Replace `YOUR_SERVER_IP` placeholders with your actual server addresses

3. Set up MCP Servers

- Use the Dockerfiles and docker-compose.yml files provided in `mcp-server-dockerfiles` to build and run your servers - Or use the instructions to set up MCP servers directly on your host - Configure each MCP server for the agents you plan to use

4. Configure Your API Keys and Credentials

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Project NOVA
  2. Project NOVA is a DIY, agent-agnostic toolkit of self-hosted
  3. [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers.
  4. Each server exposes one focused capability over Streamable HTTP so it can be
  5. used by the client, harness, or automation runtime that fits your workflow.
  6. NOVA is **not** a standalone assistant, chat application, central router, or
  7. required orchestration runtime. Use the servers with Hermes-Agent, llama.cpp
  8. WebUI, n8n, or any MCP client.
  9. Optional client-facing skill bundles are indexed in
  10. [`mcp-skills/README.md`](mcp-skills/README.md).
  11. ## What changed in v2
  12. - **25-server MCP catalog:** The repository provides 25 focused MCP servers.
  13. - **Streamable HTTP baseline:** Servers use Streamable HTTP at `/mcp` where
  14. supported; each server README documents service-specific transport and
  15. deployment caveats.
  16. - **Current implementations:** Each server directory contains its deployment
  17. files, source or image configuration, and service-specific documentation.
  18. - **Repository-local skills added:** v2 adds 25 optional skill bundles, one for
  19. each included MCP server. Use them directly from this repository or copy
  20. selected bundles into a client-supported local skills directory.
  21. - **Agent-agnostic usage:** Servers and skills work with compatible clients,
  22. harnesses, or direct MCP connections.
  23. ## What is included
  24. Every active server lives in its own directory under
  25. [`mcp-server-dockerfiles/`](mcp-server-dockerfiles/). Server READMEs contain
  26. the service-specific requirements, environment variables, and startup
  27. instructions. The current transport baseline is Streamable HTTP at `/mcp`;
  28. consult each server README for its supported transport and endpoint details.
  29. ### Included server catalog
  30. | Capability | Directory | Focus |
  31. | --- | --- | --- |
  32. | BookStack | [`bookstack-mcp`](mcp-server-dockerfiles/bookstack-mcp/) | Documentation and wiki content |
  33. | Gitea | [`gitea-mcp`](mcp-server-dockerfiles/gitea-mcp/) | Git repositories, issues, and releases |
  34. | Forgejo | [`forgejo-mcp`](mcp-server-dockerfiles/forgejo-mcp/) | Forgejo repositories and issues |
  35. | Karakeep | [`karakeep-mcp`](mcp-server-dockerfiles/karakeep-mcp/) | Bookmarks, tags, and saved content |
  36. | Memos | [`memos-mcp`](mcp-server-dockerfiles/memos-mcp/) | Notes and lightweight publishing |
  37. | Paperless-NGX | [`paperless-mcp`](mcp-server-dockerfiles/paperless-mcp/) | Documents, tags, and correspondents |
  38. | Prometheus | [`prometheus-mcp`](mcp-server-dockerfiles/prometheus-mcp/) | Metrics queries and monitoring |
  39. | TriliumNext | [`triliumnext-mcp`](mcp-server-dockerfiles/triliumnext-mcp/) | Hierarchical notes and knowledge |
  40. | Outline | [`outline-mcp`](mcp-server-dockerfiles/outline-mcp/) | Team knowledge-base documents |
  41. | Home Assistant | [`home-assistant-mcp`](mcp-server-dockerfiles/home-assistant-mcp/) | Smart-home entities and automations |
  42. | Langfuse | [`langfuse-mcp`](mcp-server-dockerfiles/langfuse-mcp/) | Prompts and observability data |
  43. | YouTube | [`youtube-mcp`](mcp-server-dockerfiles/youtube-mcp/) | Video metadata and transcripts |
  44. | Blinko | [`custom-blinko-mcp`](mcp-server-dockerfiles/custom-blinko-mcp/) | Notes, flash notes, and sharing |
  45. | Fetcher | [`fetch-mcp`](mcp-server-dockerfiles/fetch-mcp/) | Web content retrieval |
  46. | Playwright | [`playwright-mcp`](mcp-server-dockerfiles/playwright-mcp/) | Browser automation |
  47. | Filesystem | [`filesystem-mcp`](mcp-server-dockerfiles/filesystem-mcp/) | File and directory operations |
  48. | OBS | [`obs-mcp`](mcp-server-dockerfiles/obs-mcp/) | Scenes, sources, and recording |
  49. | Ableton Live | [`ableton-copilot-mcp`](mcp-server-dockerfiles/ableton-copilot-mcp/) | Music production control |
  50. | REAPER | [`reaper-mcp`](mcp-server-dockerfiles/reaper-mcp/) | Live REAPER project control |
  51. | REAPER Project QA | [`reaper-qa-mcp`](mcp-server-dockerfiles/reaper-qa-mcp/) | Offline REAPER project analysis |
  52. | CLI/Shell | [`cli-server-mcp`](mcp-server-dockerfiles/cli-server-mcp/) | Controlled command-line execution |
  53. | Nextcloud | [`nextcloud-mcp`](mcp-server-dockerfiles/nextcloud-mcp/) | Files, calendars, and collaboration |
  54. | Komodo | [`komodo-mcp`](mcp-server-dockerfiles/komodo-mcp/) | Infrastructure and deployment management |
  55. | SearXNG | [`searxng-mcp`](mcp-server-dockerfiles/searxng-mcp/) | Federated web search |
  56. | Vision Bridge | [`vision-bridge-mcp`](mcp-server-dockerfiles/vision-bridge-mcp/) | Image understanding and analysis |
  57. ## Quick start
  58. 1. Choose a server from the catalog and read its server-specific README.
  59. 2. Copy or create the required environment configuration for the service.
  60. 3. Start the server with its Docker Compose configuration:
  61. ```bash
  62. cd mcp-server-dockerfiles/<server-directory>
  63. docker compose up --build
  64. ```
  65. 4. Register the server's `http://<host>:<port>/mcp` endpoint in your MCP
  66. client or compatible harness.
  67. 5. Test the connection with a read-only operation before enabling writes or
  68. destructive actions.
  69. Most servers require the application they control to be running separately.
  70. Credentials and service URLs are intentionally configured per server rather
  71. than through a central NOVA runtime. Copy the relevant `.env.example` to
  72. `.env` locally; `.env` files are ignored and must never be published.
  73. ## Repository layout
  74. ```text
  75. project-nova/
  76. ├── README.md
  77. ├── mcp-skills/ # Optional client-facing skill bundles
  78. │ └── <skill-name>/SKILL.md
  79. └── mcp-server-dockerfiles/ # Active MCP server implementations
  80. └── <server>-mcp/
  81. ├── Dockerfile
  82. ├── docker-compose.yml
  83. ├── README.md
  84. └── startup/source files
  85. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.