and client with custom functions

MCP运维云端

提供方 ramm777

运维云端 未标注 无需鉴权 社区 / 第三方

通过n8n、Docker和WSL在本地PC上连接MCP客户端到MCP服务器及工具,实现AI系统与外部工具的安全交互。

一句话选型结论

按资料字段整理

and client with custom functions 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Dockerfile本地部署AI交互安全协议Docker部署本地开发反向代理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
and client with custom functions当前 未标注 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ramm777上游标注的维护方 ramm777
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.4 KB
来自项目仓库与上游目录的原文,未做删改

在本地电脑上使用n8n、Docker和WSL将MCP客户端连接到MCP服务器和工具

模型上下文协议(MCP)是一种强大的开放标准,它使人工智能系统,尤其是大型语言模型(LLM),能够安全地与外部工具、服务和数据源进行交互。使用MCP服务器和客户端的五大关键点:

  1. 模块化架构
    MCP客户端(AI)可以部署在AWS云上,而MCP服务器可以部署在本地PC上,因此无需将机密数据上传到云端。
  2. 标准化通信层
    由于采用了统一的JSON-RPC协议,任何MCP客户端都可以与任何符合规范的MCP服务器进行通信。
  3. 安全
    MCP(最小化配置协议或类似名称,具体根据上下文确定)允许对数据或功能进行受控暴露。MCP服务器决定暴露什么内容。
  4. 动态工具发现
    您可以插入新的服务器(例如,Google Calendar MCP或GitHub MCP),而无需重新训练或重新部署模型。

然而,这并非易事,人们在尝试这样做时会遇到错误和漏洞。本项目搭建了一个n8n MCP(模型上下文协议)服务器,配备了适当的SSL证书处理功能,以便使用Docker和Traefik反向代理进行本地开发。当在……上运行MCP时 n8n 里面 Docker 容器,你 不能 依赖自签名证书用于 localhost 因为:

  1. 容器网络导致域不匹配\
    localhost 在容器内部指的是容器本身,而不是宿主机器。

  2. MCP库强制实施HTTPS和SSE规则

  • HTTPS 连接必须使用有效且受信任的 SSL/TLS 证书。MCP 还会禁用 gzip 压缩 for 服务器发送事件 (SSE) 在 /mcp 终端节点。
  1. 在容器内部证书验证失败
  • 容器不会自动信任自签名证书。自定义域名如 n8n-demo.local 在Docker或WSL中可能无法正确解析。

解决方案:使用Traefik的反向代理架构

为了清晰地处理SSL和域名路由,请使用 Traefik(可译为“特雷法克”,但通常直接使用原名,因其为专有名词) 作为n8n前面的反向代理。主要优势:

  1. 客户端打开 https://n8n-demo.local\
    MCP客户端或浏览器尝试连接 https://n8n-demo.local在Docker容器内部,当访问n8n-demo.local时,请连接到运行Docker的计算机(主机)。```yaml
    extra_hosts:
    - "n8n-demo.local:host.docker.internal"

1. 该请求被发送到Traefik。Traefik正在监听443端口(HTTPS)。它是所有发往n8n的安全流量的入口。

1. Traefik 显示 SSL 证书(例如,使用 mkcert 创建的证书)。客户端检查证书并确认域名匹配(`n8n-demo.local`)。

1. Traefik解密HTTPS流量的安全请求(SSL终止)。在Docker网络内部,该请求变为普通的HTTP请求。

1. Traefik 将解密后的 HTTP 请求发送到端口 5678 上的 n8n 容器。

1. n8n 处理 MCP 请求。

1. Traefik 对响应进行重新加密。Traefik 从 n8n 获取原始的 HTTP 响应,再次使用 SSL 进行加密,然后通过 HTTPS 发送回客户端。

1. 客户端收到了一个安全响应

## 先决条件

- Docker 和 Docker Compose
- WSL(Windows子系统用于Linux)
- mkcert 用于本地证书生成

## 设置说明

### 1. 安装 mkcert```bash
# Install mkcert in WSL
sudo apt update
sudo apt install mkcert

# Install the root CA
mkcert -install

2. 生成证书```bash

Create certificates directory

mkdir -p certs

Generate certificates for your domain

mkcert -cert-file ./certs/n8n-demo.local.pem -key-file ./certs/n8n-demo.local-key.pem n8n-demo.local localhost 127.0.0.1


### 3. 将域名添加到主机文件中```bash
# Add domain to WSL hosts file
echo "127.0.0.1 n8n-demo.local" | sudo tee -a /etc/hosts

4. 创建配置文件

traefik-tls.yml:```yaml
tls:
certificates:
- certFile: /certs/n8n-demo.local.pem
keyFile: /certs/n8n-demo.local-key.pem
stores:
default:
defaultCertificate:
certFile: /certs/n8n-demo.local.pem
keyFile: /certs/n8n-demo.local-key.pem


**.env:(通常表示这是一个环境配置文件,用于存储应用程序的环境变量,如数据库连接信息、密钥等,具体含义需根据上下文确定)**```env
DOMAIN_NAME=n8n-demo.local
GENERIC_TIMEZONE=UTC
USERPROFILE=/home/aidan

5. 启动服务```bash

Start all services

docker-compose up -d

Check if containers are running

docker ps


### 6. 访问n8n

打开您的浏览器,然后访问: `https://n8n-demo.local`

## 关键配置详情

### 为何此方法有效

1. **`extra_hosts`**允许 n8n 解析 `n8n-demo.local` 内部地;在内部地
1. **`NODE_EXTRA_CA_CERTS`**告诉 Node.js 信任 mkcert 证书颁发机构
1. **mkcert CA 挂载**在容器内提供证书颁发机构(CA)服务
1. **MCP特定路由**禁用服务器发送事件的gzip压缩
1. **处处都是同一个域名**消除证书验证不匹配的情况

### 关键环境变量```yaml
environment:
- N8N_FEATURE_FLAG_MCP=true          # Enable MCP support
- NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/mkcert/rootCA.pem  # Trust mkcert CA
- N8N_HOST=${DOMAIN_NAME}            # Use consistent domain
- N8N_PROTOCOL=https                 # Force HTTPS

针对MCP的特定Traefik配置```yaml

Disable gzip for MCP endpoints (required for SSE)

  • traefik.http.middlewares.nogzip.headers.customResponseHeaders.Content-Encoding=""
  • traefik.http.routers.n8n_mcp.rule=Host(${DOMAIN_NAME}) && PathPrefix(/mcp)
  • traefik.http.routers.n8n_mcp.middlewares=nogzip

## 使用MCP服务器

### 1. 激活您的MCP工作流程

1. 首选 `https://n8n-demo.local`
1. 找到你的MCP工作流程(例如,“使用Google日历和自定义函数构建MCP服务器”)
1. 点击切换开关以 **激活** 工作流程
1. 工作流程应显示为“激活状态”

### 2. MCP 端点URL

- **生产环境URL**: `https://n8n-demo.local/mcp/my-functions/sse`
- **测试URL**: `https://n8n-demo.local/mcp-test/my-functions/sse` (临时的,一次性使用)

### 3. 连接MCP客户端工具

使用 **生产环境URL** 在您的MCP客户端工具中:

# 创建证书目录

创建目录(递归创建,若目录不存在则创建)certs

# 为您的域名生成证书

mkcert -cert-file ./certs/n8n-demo.local.pem -key-file ./certs/n8n-demo.local-key.pem n8n-demo.local localhost 127.0.0.1 验证域名是否在hosts文件中: `cat /etc/hosts | grep n8n-demo`

2. **“Bad Gateway”错误**

- 检查容器日志: `docker logs mcp_server_and_client_with_custom_functions_n8n_1`
- 确保没有端口冲突(n8n 应运行在 5678 端口,Traefik 运行在 443 端口)

1. **证书验证错误**

- 重新生成证书: `mkcert -cert-file ./certs/n8n-demo.local.pem -key-file ./certs/n8n-demo.local-key.pem n8n-demo.local localhost 127.0.0.1`
- 重启容器: `docker-compose down && docker-compose up -d`

### 测试设置```bash
# Test the MCP endpoint
curl -k https://n8n-demo.local/mcp/my-functions/sse

# Should return SSE data like:
# event: endpoint
# data: /mcp/my-functions/messages?sessionId=...

将域名添加到主机文件中

将 "127.0.0.1 n8n-demo.local" 追加到 /etc/hosts 文件中(使用sudo权限):echo "127.0.0.1 n8n-demo.local" | sudo tee -a /etc/hosts

  • MCP需要HTTPS 持有有效证书
  • Docker 网络 导致域名解析问题
  • 自签名证书 不跨容器边界工作
  • 直接端口访问 绕过正确的SSL终止处理

  • 提供一致的域名解析

  • 正确处理SSL终止
  • 消除证书验证不匹配的情况
  • 与MCP客户端工具配合使用

这个设置是基于“在MCP服务器上运行n8n:文档不完善的SSL证书挑战”中描述的解决方案,并针对WSL/Windows环境进行了调整。

创建配置文件

  • .env(通常表示环境配置文件)

启动服务

访问N8N

打开你的浏览器,然后访问:https://n8n-demo.local

为何这种架构是必要的

  • 在Docker环境中,MCP服务器面临一个根本性挑战:
  • MCP要求使用带有有效证书的HTTPS
  • Docker 网络设置导致域名解析问题
  • 自签名证书在容器边界之间无法正常工作
  • 直接端口访问绕过了正确的SSL终止处理
  • 反向代理解决方案是唯一可靠的方法,它:
  • 提供一致的域名解析
  • 正确处理SSL终止
  • 消除证书验证不匹配问题
  • 与MCP客户端工具配合使用

致谢/鸣谢

功劳/学分

这个设置是基于文中描述的解决方案 “在MCP服务器上运行N8N:SSL证书文档缺失的挑战” 并且已从MacOS环境适配到WSL/Windows环境。它也是从……发展而来的
"Bitovi n8n 入门仓库"

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
and client with custom functions 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

and client with custom functions 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

and client with custom functions 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

and client with custom functions 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

and client with custom functions 能提供哪些能力?

资料显示能力标签包括 安全协议、本地开发、Docker、AI交互。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。