neoforge-mcp-server
0
The Terminal Command Runner MCP Server is designed to facilitate terminal command execution and file system management for AI assistants. It offers extensive APIs for terminal management, file operations, and advanced features like system info retrieval and math expression evaluation. Command blacklisting and other security measures are implemented to ensure safe operation.
Terminal Command Runner MCP Server
A powerful Model Control Protocol (MCP) server providing terminal command execution and file system management capabilities via a RESTful API.
🌟 Features
Terminal Management
- Execute commands with timeouts
- Manage background processes
- Fetch command output
- List active sessions and processes
- Terminate processes
- Command blacklisting
File System Operations
- Read/write files
- Create directories
- List directory contents
- Move/rename files
- Search files with patterns
- Get file details
Advanced Features
- Text editing with search and replace
- System information retrieval
- Mathematical expression evaluation
🚀 Quick Start
Prerequisites
- Python 3.13+
- UV package manager
Installation
- Clone the repository
- Create a virtual environment
- Start the MCP server
🧪 Testing
- Verify functionality with a comprehensive test suite
🔧 Configuration
- Configure with a JSON file for MCP service
📖 API Reference
- Terminal and File System Tools
🔒 Security Considerations
- Command blacklisting
- File size limits
- Safety checks
🤝 Contributing
- Contributions welcome via Pull Request
📄 License
- Licensed under MIT License