关键词

命令执行本地命令隔离环境工具执行系统命令

使用说明

项目简介

'isolated-commands-mcp-server' 是一个基于 Model Context Protocol (MCP) 的服务器实现，它演示了如何通过 MCP 协议在本地环境中隔离地执行命令。该服务器提供了一个简单的工具，允许客户端请求服务器执行指定的命令，并返回命令执行的结果。

主要功能点

  • 工具 (Tools):
    • 'run_command': 允许客户端请求服务器执行指定的命令。命令在服务器的隔离环境中运行。

安装步骤

  1. 安装依赖: 确保你安装了 Node.js 和 npm。在仓库根目录下，运行以下命令安装项目依赖：

    npm install

  2. 构建服务器: 运行以下命令编译 TypeScript 代码并生成可执行的 JavaScript 文件：

    npm run build

    构建完成后，会在 'build' 目录下生成 'index.js' 文件，这就是服务器的入口文件。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，你需要配置客户端，告知其如何启动和连接到此服务器。以下是在 'claude_desktop_config.json' 文件中配置 'isolated-commands-mcp-server' 的示例配置：

{
  "mcpServers": {
    "isolated-commands-mcp-server": {
      "command": "/path/to/isolated-commands-mcp-server/build/index.js"
    }
  }
}
  • 'server name': 'isolated-commands-mcp-server' - 服务器的名称，用于在客户端配置中标识该服务器。
  • 'command': '/path/to/isolated-commands-mcp-server/build/index.js' - 请替换为 'isolated-commands-mcp-server' 项目 'build/index.js' 文件的实际绝对路径。 这是启动 MCP 服务器的命令。

基本使用方法

  1. 启动服务器: MCP 服务器不需要手动启动。当 MCP 客户端（如 Claude Desktop）需要与该服务器交互时，客户端会根据配置文件中的 'command' 自动启动服务器。

  2. 客户端调用工具: 在支持 MCP 协议的客户端中，你可以通过调用 'run_command' 工具来请求服务器执行命令。你需要提供 'command' 参数，指定要执行的命令。服务器会执行该命令，并将执行结果以文本形式返回。

例如，在 Claude Desktop 中，你可以指示 Claude 使用 'run_command' 工具，并提供要执行的命令，例如： “使用 'run_command' 工具执行 'ls -l' 命令”。 服务器将会执行 'ls -l' 命令，并将结果返回给 Claude。

调试

如果需要调试 MCP 服务器，可以使用 MCP Inspector。 运行以下命令启动 Inspector：

npm run inspector

Inspector 会提供一个 URL，你可以在浏览器中打开该 URL 来访问调试工具。

信息

分类

桌面与硬件

访问项目