mcp-for-shell 使用说明：安装、接入 OpenCode 与 Web 管理

使用说明

本文档说明三件事：

  1. 软件的安装
  2. 如何接入 OpenCode
  3. 需要便捷配置服务器列表时，如何开启 Web 端

一、软件安装

项目目录：/home/miao/AI/mcp-shell/mcp-for-shell

当前源码目录已经整理到：source/

  • 后端源码：source/src/
  • Web 页面源码：source/web/

安装步骤：

1
2
3
cd /home/miao/AI/mcp-shell/mcp-for-shell
npm install
npm run build

构建完成后，启动入口是：dist/index.js

开发模式可直接运行：

1
2
cd /home/miao/AI/mcp-shell/mcp-for-shell
npm run dev

二、接入 OpenCode

OpenCode 使用本地 MCP 时，建议使用 stdio 模式。

配置文件：~/.config/opencode/opencode.json

推荐配置如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "mcp": {
    "mcp-for-shell": {
      "type": "local",
      "command": [
        "node",
        "/home/miao/AI/mcp-shell/mcp-for-shell/dist/index.js"
      ],
      "environment": {
        "MCP_TRANSPORT": "stdio",
        "MCP_SERVER_CONFIG": "/home/miao/AI/mcp-shell/mcp-for-shell/config/servers.json"
      },
      "enabled": true
    }
  }
}

说明：

  • command 指向构建后的 dist/index.js
  • MCP_TRANSPORT=stdio 表示作为本地 MCP 使用
  • MCP_SERVER_CONFIG 指向服务器配置文件

配置完成后，重启 OpenCode 即可加载。

三、需要便捷配置服务器列表时如何开启 Web 端

如果你需要通过页面快速维护服务器列表，不要用 stdio 模式启动 Web。

Web 端需要使用 HTTP 模式启动。

最简命令：

1
2
cd /home/miao/AI/mcp-shell/mcp-for-shell
MCP_HTTP_PORT=3000 node dist/index.js

如果你想指定一个默认配置文件路径，也可以这样启动：

1
2
3
4
cd /home/miao/AI/mcp-shell/mcp-for-shell
MCP_HTTP_PORT=3000 \
MCP_SERVER_CONFIG="/home/miao/AI/mcp-shell/mcp-for-shell/config/servers.json" \
node dist/index.js

启动后访问：

1
http://127.0.0.1:3000/admin

当前 Web 端的使用方式是：

  1. 点击“读取已有配置文件”，读取本地已有 servers.json
  2. 如果没有现成配置，点击“选择生成路径”指定新的本地保存位置
  3. 在页面里录入服务器条目
  4. 点击“保存到本地文件”写入配置

补充说明：

  • Web 端使用浏览器本地文件选择能力，建议使用 Chromium 内核浏览器
  • Web 端适合“便捷配置服务器列表”
  • OpenCode 本地 MCP 适合“让 Agent 直接调用工具”
  • 两者可以分别启动，互不影响