AI工具连接协议

MCP是一种为AI助手提供直接访问工具和数据的方式,简化了AI与工具之间的连接过程,适用于需要快速集成AI功能的开发者。

  • by LETHALDOSE1300
  • Shell
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 LETHALDOSE1300/johns-private-mcp-setup

使用说明

MCP入门套件:比n8n更简单的替代方案

致西德:欢迎加入GitHub!你只用了一年的时间就达到了这个水平。迟到总比不做好

MCP到底是什么鬼?

模型上下文协议(MCP) 这是一种让您的AI助手(如Claude、ChatGPT或本地大型语言模型)直接访问工具和数据的方式。可以将其视为AI的USB端口——您只需将“服务器”(即工具)连接上去,您的AI就能立即读取文件、调用API、浏览网页、管理Docker容器,以及执行更多操作。

简化版: 无需在你的AI聊天界面和终端之间每天复制粘贴500次,MCP让你的AI直接完成这项工作。

为何存在此(以及为何你目前还不需要n8n)

你一直在考虑用n8n来连接你的AI和各种工具。这就像你需要搬张沙发,却去买了一辆半挂卡车。现实情况是:

任务 n8n MCP
建立时间(或设置时间) 2-4小时 10分钟
维护 每周更新、Docker容器、工作流调试 基本没有
复杂性 可视化工作流构建器,各处都有网络钩子、API密钥 JSON配置文件
隐私 自托管但复杂 所有内容本地运行
最适合用于 复杂的多步骤自动化、计划任务、集成50+服务 为您的AI提供直接的工具访问权限

总结来说: 从MCP开始。如果你发现自己在想“我需要根据计划触发15个不同的API,并将结果发送到3个不同的地方” 然后 看看n8n。

快速入门(5分钟,我保证)

# 1. Clone this repo
git clone https://github.com/LETHALDOSE1300/johns-private-mcp-setup.git
cd johns-private-mcp-setup

# 2. Install essential MCP servers
chmod +x servers/install-essentials.sh
./servers/install-essentials.sh

# 3. Configure your AI (Claude Desktop, Ollama, etc.)
# Copy the appropriate config from config/ folder
# Instructions in config/README.md

# 4. Restart your AI application

# 5. Try it out!
# Open your AI and say: "List the files in my home directory"

就这样。 如果它成功了,你的AI已经读取了你的文件系统。欢迎来到MCP(可能指某种高级或恶意的计算机系统或程序)。

包含内容

基本服务器(从这里开始)

  • 文件系统 - 读取/写入文件,搜索目录
  • 获取 - 调用API,获取网页内容
  • GitHub - 管理仓库、问题、拉取请求(PRs)
  • 顺序思维 - 对复杂任务具有更强的推理能力

高级服务器(按需添加)

  • “puppeteer”翻译成中文是“操控者”或“木偶师”。这个词通常用来形容那些能够操控或引导他人行为的人,或者比喻为像木偶师一样操控着木偶(即被操控者)的人。在更广泛的语境中,它也可以指任何能够熟练地操纵或指导他人完成特定任务或行为的人 - 浏览器自动化,网页抓取
  • Docker - 容器管理
  • 记忆 - 跨对话的持久记忆
  • 命令 - 运行终端命令(功能强大,请谨慎使用)

仓库结构

.
├── README.md                          ← You are here
├── ACTUALLY_READ_THIS.md              ← Start here after cloning
├── WHY_THIS_EXISTS.md                 ← Deep dive on MCP vs n8n
├── config/
│   ├── README.md                      ← Config setup instructions
│   ├── claude-desktop-config.json     ← Claude Desktop config
│   └── ollama-config.json             ← Ollama/Open WebUI config
├── servers/
│   ├── README.md                      ← Server overview
│   ├── install-essentials.sh          ← One-click essential install
│   ├── install-advanced.sh            ← Advanced servers install
│   └── server-guide.md                ← Detailed server docs
├── sandbox/
│   ├── README.md                      ← Testing instructions
│   ├── sample-prompts.md              ← Copy-paste test prompts
│   ├── test-filesystem.md             ← Filesystem tests
│   └── setup-test-environment.sh      ← Auto-create test env
├── examples/
│   ├── README.md                      ← Example overview
│   ├── basic-file-operations.md       ← File handling examples
│   ├── api-calling-patterns.md        ← API usage patterns
│   ├── web-automation.md              ← Puppeteer examples
│   └── docker-management.md           ← Docker examples
└── troubleshooting/
    ├── common-issues.md               ← Fix common problems
    └── setup-checklist.md             ← Verification steps

开始此处指南

  1. 阅读 ACTUALLY_READ_THIS.md 文件 - 10分钟实操测试
  2. 运行基本组件安装程序 - 获取核心服务器
  3. 配置你的AI - 复制配置,自定义路径
  4. 在沙盒中进行测试 - 确保一切正常运作
  5. 试试这些例子 - 学习可以重复使用的模式
  6. 建造某物 - 现在你很危险

为何存在此仓库

你是一位注重隐私的开发者,编程经验一年,上周刚发现GitHub,目前正在通过ChatGPT学习一切。你正打算设置n8n来连接你的AI到各种工具,这就好比用喷火枪来点燃一根蜡烛。

这个仓库是一个干预措施。MCP更简单、更私密,而且正是你现在所需要的。以后,当你实际构建复杂的多服务工作流时,我们可以再谈谈n8n。

接下来怎么办?

  • `ACTUALLY_READ_THIS.md` —— 你的实际起点
  • WHY_THIS_EXISTS.md — 如果你仍然不相信,请进行深入比较
  • sandbox/ — 在安全环境中测试一切
  • examples/ — 你可以复制的真实模式
  • 故障排除/ — 当事情不可避免地出现故障时

附言:欢迎来到GitHub!你会很快融入这里的。别再想太多,直接运行安装程序吧。

用咖啡和轻微的恼怒制成 | 如果有帮助请点赞 | 欢迎指出问题