ai-agents-swiss-knife
为AI编码代理提供本地化、安全的MCP工具服务器。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ai-agents-swiss-knife。 它的用途是：为AI编码代理提供本地化、安全的MCP工具服务器。 完整的 Skill 内容见：https://321skill.com/skills/ai-agents-swiss-knife/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查当前Git仓库的状态，并列出src目录下所有修改过的.py文件。” 它会通过配置好的MCP服务器调用Git和文件系统工具，安全地获取信息并返回给你。或者，你可以说：“在项目根目录下运行测试命令。” AI会通过该工具在受控的沙箱环境中执行Shell命令，而不会影响你本机的其他进程。
介绍
AI Agent’s Swiss Knife 是一个面向MCP（模型上下文协议）的本地工具服务器，旨在为AI编码代理提供安全、可控的执行环境。它通过HTTP端点暴露了一系列常用开发工具，如Shell执行、文件系统操作、Git管理、进程管理等，让AI助手能在沙箱内安全地协助用户完成开发任务。
使用上，用户只需通过pip安装，运行一个本地服务器，并在AI客户端（如Codex CLI）中配置指向该服务器的桥接器即可。服务器启动后提供一个Web仪表板，用于查看日志和策略，并默认在本地8000端口提供服务。
这个工具非常适合需要AI助手深度参与本地开发流程的开发者，尤其是那些希望AI能安全执行文件读写、运行命令或管理Git等操作，但又不想将敏感代码或环境暴露给云端服务的场景。
建议在受控的开发环境中使用，并注意通过环境变量（如MCP_ALLOWED_BASE）严格限制AI可访问的根目录，以确保操作安全。首次使用时，请确保客户端有足够的连接超时时间（如60秒）来完成握手。
核心特点
它将多种本地开发工具（Shell、文件系统、Git、进程等）统一封装为安全的HTTP端点，并通过MCP协议标准化接入，为AI代理提供了开箱即用、安全可控的“瑞士军刀”式工具箱，避免了为每个工具单独配置的麻烦。
注意事项
不适合需要高性能计算、图形界面操作或直接访问系统底层硬件的场景。
常见问题
如何修改服务器监听的端口？
通过设置环境变量 `MCP_PORT`，例如 `export MCP_PORT=8080`。
AI客户端连接超时怎么办？
请检查服务器是否运行在正确端口，并增加客户端的 `startup_timeout_sec` 配置（例如设为60秒）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ai-agents-swiss-knife/raw/index.md 读取 ai-agents-swiss-knife 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ai-agents-swiss-knife/raw/index.md（查看排版版本）