n8n Assistant
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.
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
httpxlibrarybeautifulsoup4librarypython-dotenvlibrary
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
-
Clone this repository:
git clone <repository-url> cd <repository-directory>
-
Install the required dependencies:
pip install -r requirements.txt
-
Create a
.envfile 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)
| File | Size | Uploaded | |
|---|---|---|---|
| iflow_mcp_n8n_assistant-0.1.0.tar.gz | 4.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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}
|