AI导哈

Shell服务器接口层

MCP Shell是一个用于代理MCP STDIO流量到外部shell-server进程的接口层工具。

  • by mako10k
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mako10k/mcp-shell

使用说明

mcp外壳

shell服务器的MCP接口层。此程序包启动 @mako10k/shell-server 作为外部服务器进程和代理MCP 该进程的STDIO流量。

安装

npm install -g @mako10k/mcp-shell

或者直接运行：

npx -y @mako10k/mcp-shell --help

构建

npm install
npm run build

发布

稳定版本清单（简短版）：

  1. 更新 CHANGELOG.md ([Unreleased])并拆分下一个版本部分。
npm run changelog:release -- <version>
  1. 运行提交前质量检查。
npm install
npm run build
npm audit
npm run test:e2e
  1. 不带自动标记/提交的Bump版本（SemVer）。
npm version patch --no-git-tag-version
# or: npm version minor --no-git-tag-version
# or: npm version major --no-git-tag-version
  1. 提交发布更改并创建带注释的标签。
git add package.json package-lock.json CHANGELOG.md
git commit -m "chore(release): <version>"
git tag -a v<version> -m "Release v<version>"
  1. 推送分支并标记。
git push origin main
git push origin v<version>
  1. 发布包并更新GitHub版本。
npm publish
gh release create v<version> --title "v<version>" --generate-notes
# if release already exists:
gh release edit v<version> --title "v<version>" --notes-file <release-note-file>

备注

  • 运行时依赖关系： @mako10k/shell-server （建议： >=0.2.4)
  • 外部环境接口保持 MCP_SHELL_DEFAULT_WORKDIR 作为主要。
  • SHELL_SERVER_DEFAULT_WORKDIR 被接受为兼容性别名。
  • 允许的工作目录列表由提供 SHELL_SERVER_ALLOWED_WORKDIRS.
  • 此包遵循shell服务器v0.2.x子守护进程字段(childSocketPath/child.sock).
  • mcp-shell 不再在进程中运行MCP实现。
  • 它通过服务器管理器启动（或重用）shell服务器进程并连接 通过守护进程套接字代理。

相关 MCP