概要
What is STeLA MCP?
STeLA (Simple Terminal Language Assistant) MCP is a lightweight Python implementation of a Model Context Protocol server that provides secure access to local machine commands and file operations via a standardized API interface. It acts as a bridge between applications and the local system, implementing the MCP architecture.
How to use STeLA MCP?
Install via Smithery (npx -y @smithery/cli install @Sachin-Bhat/stela-mcp --client claude) or manually by cloning the repository, creating a virtual environment, and installing dependencies. Configure environment variables for directory access (ALLOWED_DIRS, ALLOWED_DIR), command security (ALLOWED_COMMANDS, ALLOWED_FLAGS, MAX_COMMAND_LENGTH, COMMAND_TIMEOUT), then start the server with uv run python -m src.stella_mcp.server. Use with Claude Desktop by adding it as an MCP tool.
Key features of STeLA MCP
- Command execution with robust error handling
- File operations: read, write, edit, move, search
- Recursive directory tree visualization
- Multi‑directory support for file operations
- Security‑first design with strict path validation
- Strong type checking with Pydantic models
Use cases of STeLA MCP
- Execute shell commands from an AI assistant on a local machine
- Read, write, and edit files within allowed directories
- Search files and generate directory trees for project navigation
- Integrate with Claude Desktop for secure local system access
- Manage file operations programmatically via a standardized API
FAQ from STeLA MCP
What are the runtime requirements for STeLA MCP?
Python 3.10–3.12, pip or uv package manager, and Pydantic v2.x.
How does STeLA MCP ensure security?
It enforces allowed directories (ALLOWED_DIRS), allowed commands (ALLOWED_COMMANDS), allowed flags (ALLOWED_FLAGS), command length limits, timeouts, and performs strict path validation including symlink and parent directory checks.
What transport does STeLA MCP use?
The server listens for connections through standard I/O (stdio interface).
Can I create a binary distribution of STeLA MCP?
Yes, you can create a self-contained binary using PyInstaller: pyinstaller --onefile src/stella_mcp/server.py --name stela-mcp.
What are the default allowed commands and flags?
Default allowed commands: ls,cat,pwd,echo. Default allowed flags: -l,-a,-h,--help. Both can be overridden or set to all (not recommended).
