MCP HubMCP Hub
PhialsBasement

CMD-MCP-Server

by: PhialsBasement

MCP server for executing CMD commands. Can be hooked to claude for additional agentics.

9created 04/12/2024
Visit
CMD
Claude

📌Overview

Purpose: To provide a platform for executing CMD commands on Windows and Linux systems through a Model Context Protocol (MCP) framework.

Overview: The CMD MCP Server is a versatile server implementation designed to facilitate the execution of command-line operations within MCP-compatible applications. It supports cross-platform functionality, making it suitable for a wide range of environments and use cases.

Key Features:

  • Execute CMD commands through MCP: Enables seamless integration of command-line tasks within applications that utilize the MCP framework.

  • TypeScript implementation: Built using TypeScript for enhanced type safety and clarity in development.

  • Built on the official MCP SDK: Utilizes the official Software Development Kit to ensure full compatibility with MCP standards.

  • Cross-platform compatibility: Supports both Windows and Linux, allowing flexibility in deployment and usage.

CMD MCP Server

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.

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:

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

Manual Installation

npm install server-cmd

Prerequisites

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

Usage

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:

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

const server = new MCPCmdServer(config);

Development

To set up the development environment:

  1. Clone the repository:
git clone https://github.com/PhialsBasement/CMD-MCP-Server.git
cd CMD-MCP-Server
  1. Install dependencies:
npm install
  1. Build the project:
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

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:
https://github.com/PhialsBasement/CMD-MCP-Server/issues