@phialsbasement/cmd-mcp-server: CMD MCP Server

phialsbasement/cmd-mcp-server
9

CMD MCP Server is a cross-platform server enabling command-line execution via the Model Context Protocol (MCP). It supports CMD commands on Windows and Linux, SSH connections, and seamless integration with MCP-compatible applications. Built on the MCP SDK and written in TypeScript, it’s ideal for automating command-line operations in a secure, scalable manner.

❓unknown

Author

phialsbasement

View on GitHubVisit Website

README

CMD MCP Server

smithery badge npm downloads A Model Context Protocol (MCP) server implementation for executing CMD commands on both Windows and Linux, as well as allowing SSH connections. This server allows you to integrate command-line operations with MCP-compatible applications.

cmd-mcp-server MCP server

Features

  • Execute CMD commands through MCP
  • TypeScript implementation
  • Built on the official MCP SDK
  • Cross-platform compatibility

Installation

Installing via Smithery

To install CMD Server for Claude Desktop automatically via Smithery:

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

Manual Installation

bash
npm install server-cmd

Prerequisites

  • Node.js (v16 or higher recommended)
  • npm or yarn package manager

Usage

typescript
import { MCPCmdServer } from 'server-cmd';

// Initialize the server
const server = new MCPCmdServer();

// Start the server
server.start();

Configuration

The server can be configured through environment variables or a configuration object:

typescript
const config = {
  // Add your configuration options here
};

const server = new MCPCmdServer(config);

Development

To set up the development environment:

  1. Clone the repository:
bash
git clone https://github.com/PhialsBasement/CMD-MCP-Server.git
cd CMD-MCP-Server
  1. Install dependencies:
bash
npm install
  1. Build the project:
bash
npm run build

Scripts

  • npm run build - Compile TypeScript to JavaScript
  • npm run prepare - Prepare the package for publishing

Dependencies

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Security

Please note that executing command-line operations can be potentially dangerous. Make sure to implement proper security measures and input validation when using this server in production environments.

Support

For issues and feature requests, please use the GitHub issue tracker.