mcp-extended-tools/README.md

Extended tools for command execution

# MCP Extended Tools

Extended toolset for Model Context Protocol including command execution and terminal monitoring capabilities.

## Project Development Plan

### 1. Fix Package Structure
- [x] Update version to 1.6.6 to match documentation
- [x] Add missing dependencies:
  - [x] chokidar for file watching
  - [x] portfinder for automatic port assignment
- [x] Consolidate duplicate code between command-executor.js and commands.js
- [x] Clean up package.json structure

### 2. MCP Server Integration
- [x] Expand MCP server capabilities
  - [x] Implement watch_terminal feature
  - [x] Implement stop_process capability
  - [x] Add list_processes functionality
- [x] Add comprehensive error handling
- [x] Implement proper logging system
- [x] Add capability negotiation

### 3. Core Features Implementation
- [x] Terminal Monitoring System
  - [x] Real-time output streaming
  - [x] Terminal session management
  - [x] Output buffering and retrieval
- [x] Process Management
  - [x] Process lifecycle management
  - [x] Resource cleanup
  - [x] Auto-restart capability
- [x] File Watching
  - [x] Configure watch paths
  - [x] Implement ignore patterns
  - [x] Handle file change events
- [x] Logging System
  - [x] Implement log rotation
  - [x] Add cleanup policies
  - [x] Configure log levels

### 4. Documentation
- [ ] Update README with accurate feature list
- [ ] Add detailed usage examples for each capability
- [ ] Document error handling and troubleshooting
- [ ] Add configuration documentation
- [ ] Include security considerations

## Installation
```bash
npm install mcp-extended-tools
```

## Configuration
Add to your Claude Desktop configuration:
```json
{
  "mcpServers": {
    "extended-tools": {
      "command": "npx",
      "args": ["-y", "mcp-extended-tools@1.6.6"]
    }
  }
}
```

## Features
1. Execute Commands
2. Monitor Output
3. Stop Processes
4. List Active Processes
5. File Watching
6. Auto-Restart
7. Log Management

## Usage Examples
Coming soon...

## Security Considerations
Coming soon...

## Error Handling
Coming soon...

## Contributing
Contributions are welcome! Please check the development plan above for current priorities.