内容
🚀 OrbStack MCP 工具
一套轻量级的 ZSH 函数，用于在 Docker 容器中管理 **模型上下文协议（MCP）** 服务器。
针对 **macOS + OrbStack** 进行优化，此工具包允许您在主机上无需安装 Node.js 或 npm 即可通过 `npx` 运行任何 MCP 服务器。
## ✨ 功能特点
- **主机清洁**: 您的 Mac 上无需 Node.js/npm。所有操作都在隔离的 `node:alpine` 容器中运行。
- **OrbStack 魔术**: 为 HTTP/SSE 服务器提供自动本地域名（例如，`http://orb.local`）。
- **双模式支持**：
- **STDIO**: 适用于 Claude Desktop（容器随客户端自动启动和停止）。
- **SSE（HTTP）**: 适用于 LM Studio 和后台任务（始终可通过本地 URL 访问）。
- **自动配置**: 为 Claude Desktop 或 LM Studio 设置生成即用 JSON 块。
## 📦 安装
在您的终端中运行以下命令：
```bash
curl -s https://raw.githubusercontent.com/nut-code-monkey/mcp-tools/refs/heads/main/mcp-tools -o ~/.mcp-tools && source ~/.mcp-tools安装完成后，重新加载您的 shell 环境：
```bash
source ~/.rc
```
## 方法
### 1. STDIO 模式
使用 `-create` 生成配置。容器将由 Claude Desktop/LL Studio 管理。
```bash
mcp-create my-server npx -y @modelcontextprotocol/server-everything
```
输出 MCP 配置：
```json
{
"mcpServers": {
"my-server": {
"command": "zsh",
"args": ["-c", "source ~/.zshrc &&-run my-server npx -y @modelcontextprotocol/server-everything"]
}
}
}
```
将其复制到 MCP `config.json` 中。
### 2. SSE 模式
使用 `mcp-create-http`。容器将在后台运行，并unless-stopped` 重启策略。
```bash
m-http my-server 3001 npx -y @modelcontextprotocol/server-everything sse
```
*您的服务器将在此处提供服务：`http://orb.local`*
输出 MCP 配置：
```json
{
"mcpServers": {
"my-server": {
"type": "sse",
"url": "http://my-server.orb.local:3001/sse"
}
}
}
```
## 📑 核心命令
| 命令 | 描述 |
| :--- | :--- |
| `mcp-create <name> <command>` | 生成 STDIO JSON 配置 |
| `mcp-create-http <name> [port] <command>` | 在后台启动 SSE 服务器并提供 URL/JSON |
## ⚙️ 要求
- **macOS**
- **OrbStack**（推荐）或 Docker Desktop
## 📝
1. **文件访问**: 您运行命令的当前工作目录将挂载到容器内的`。
2. **环境 对于 STDIO 容器手动将 API 密钥添加到 的 `"env"` 部分. **持久性**: 通过 `mcp-create-http` 启动将根据 OrbStack/D策略在系统重启后。
