Skip to main content

n8n Assistant

smithery badge

This project contains a Multi-Channel Platform (MCP) server used to create an assistant integrated with n8n. The assistant can be used to search for n8n documentation, example workflows, and community forums.

n8n-asistans MCP server

Features

  • Web Search: Searches n8n documentation, workflows, and community forums based on a specific query.
  • HTML Content Fetching: Uses BeautifulSoup to extract the main content from search results.
  • Asynchronous Processing: Performs HTTP requests asynchronously, providing faster response times.

Requirements

  • Python 3.7 or higher
  • httpx library
  • beautifulsoup4 library
  • python-dotenv library

Installation

Installing via Smithery

To install n8n-assistant for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @onurpolat05/n8n-assistant --client claude

Manual Installation

  1. Clone this repository:

    git clone <repository-url>
    cd <repository-directory>
    
  2. Install the required dependencies:

    pip install -r requirements.txt
    
  3. Create a .env file and add the necessary API keys:

    SERPER_API_KEY=your_api_key_here
    

Usage

To start the assistant, run the following command:

uvicorn main:app --reload

Then, you can query the assistant for information related to n8n like this:

await get_n8n_info("HTTP Request node", "docs")

MCP Server

This project uses the n8n-asistans MCP server. The server is started with the following command:

{
    "mcpServers": {
        "n8n-asistans": {
            "command": "uv",
            "args": [
                "--directory",
                "/n8n-assistant",
                "run",
                "main.py"
            ],
            "env":{
                "SERPER_API_KEY": "*********"
            }
        }
    }
}

Contributing

If you would like to contribute, please create a pull request or report issues.

License

This project is licensed under the MIT License.

Metadata

Release files for iflow-mcp_n8n-assistant 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_n8n-assistant 0.1.0
File Size Uploaded
iflow_mcp_n8n_assistant-0.1.0.tar.gz 4.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_n8n-assistant 0.1.0
File Interpreter ABI Platform
iflow_mcp_n8n_assistant-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.9 kB

Release files / iflow_mcp_n8n_assistant-0.1.0.tar.gz

Download URL iflow_mcp_n8n_assistant-0.1.0.tar.gz
Size 4.6 kB
Tags Source
SHA-256 checksum
How to use checksums
c4170dbfa72135277ae307d6738285048ee6a14750978f4b2c85b4a22e3222f7
BLAKE2b-256 checksum
How to use checksums
888690c5c0ef4f6f3246934db04719eab3cf32e63ee0938897bf4019edb184e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_n8n_assistant-0.1.0-py3-none-any.whl

Download URL iflow_mcp_n8n_assistant-0.1.0-py3-none-any.whl
Size 5.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5e24b27cb4f84faa3f62d9149bdbcf0d347ad31cbc9a50bc6a552c437f67966
BLAKE2b-256 checksum
How to use checksums
716da595992aa4d1ad7d0f085dbb55c54a251edaeb9247e18955dab5d7e91539
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page