返回 MCP 目录
public公开dns本地运行

PhialsBasement_CMD-MCP-Server

一个基于Model Context Protocol (MCP)的服务器实现,用于在Windows和Linux系统上执行CMD命令及SSH连接,支持通过MCP兼容应用集成命令行操作。

article

README

🚀 CMD MCP 服务器

一个用于在 Windows 和 Linux 上执行 CMD 命令的 Model Context Protocol (MCP) 服务器实现,支持 SSH 连接。该服务器允许您将命令行操作与 MCP 兼容的应用程序集成,为跨平台的命令执行提供了便利。

smithery badge

🚀 快速开始

本服务器可让您轻松将命令行操作与 MCP 兼容的应用程序集成。以下是使用示例:

import { MCPCmdServer } from 'server-cmd';

// 初始化服务器
const 服务器 = new MCPCmdServer();

// 启动服务器
服务器.start();

✨ 主要特性

  • 执行通过 MCP 的 CMD 命令
  • TypeScript 实现
  • 基于官方 MCP SDK 构建
  • 跨平台兼容性

📦 安装指南

使用 Smithery 进行安装

要通过 Smithery 自动为 Claude Desktop 安装 CMD 服务器,可执行以下命令:

npx -y @smithery/cli install server-cmd --client claude

手动安装

npm install server-cmd

先决条件

  • Node.js (建议 v16 或更高版本)
  • npm 或 yarn 包管理器

💻 使用示例

基础用法

import { MCPCmdServer } from 'server-cmd';

// 初始化服务器
const 服务器 = new MCPCmdServer();

// 启动服务器
服务器.start();

高级用法

可以通过环境变量或配置对象来配置服务器:

const 配置 = {
  // 在此处添加您的配置选项
};

const 服务器 = new MCPCmdServer(配置);

📚 详细文档

开发环境搭建

要设置开发环境,可按以下步骤操作:

  1. 克隆仓库:
git clone https://github.com/PhialsBasement/CMD-MCP-Server.git
cd CMD-MCP-Server
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

脚本

  • npm run build - 将 TypeScript 编译为 JavaScript
  • npm run prepare - 为发布准备包

依赖项

  • @modelcontextprotocol/sdk: ^1.0.1
  • glob: ^10.3.10
  • zod-to-json-schema: ^3.23.5

🔧 技术细节

本项目使用 TypeScript 实现,基于官方 MCP SDK 构建,具有跨平台兼容性。通过执行 MCP 的 CMD 命令,可将命令行操作与 MCP 兼容的应用程序集成。

📄 许可证

此项目根据 MIT License 发布 - 详见 LICENSE 文件以获取详细信息。

⚠️ 重要提示

请注意,执行命令行操作可能具有潜在危险。在生产环境中使用此服务器时,请确保实施适当的安全措施和输入验证。

💡 使用建议

对于问题和功能请求,请使用 GitHub 问题跟踪器 提交反馈。欢迎贡献!请随时提交 Pull Request。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端