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_onurpolat05-mcp-example 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_onurpolat05-mcp-example 0.1.0
File Size Uploaded
iflow_mcp_onurpolat05_mcp_example-0.1.0.tar.gz 4.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_onurpolat05-mcp-example 0.1.0
File Interpreter ABI Platform
iflow_mcp_onurpolat05_mcp_example-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 10.0 kB

Release files / iflow_mcp_onurpolat05_mcp_example-0.1.0.tar.gz

Download URL iflow_mcp_onurpolat05_mcp_example-0.1.0.tar.gz
Size 4.6 kB
Tags Source
SHA-256 checksum
How to use checksums
43220955c85079dba565beb7d88e49774757f46a4e4cd0ba08d3829e3fe0c350
BLAKE2b-256 checksum
How to use checksums
7dde0d6009eb4207a30846084e500177614bf98c0eab477ced19fc104556e20d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

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

Download URL iflow_mcp_onurpolat05_mcp_example-0.1.0-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e5b11e71d2951a55c2a0692fc0de6d547142ec232e8031d75727479df1544bf8
BLAKE2b-256 checksum
How to use checksums
0a4b6795bdea51e4f0b1c0b6fa2a7a5ae404467009be22fa1c6e10d1662a2980
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","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