iflow-mcp_blazickjp_shell-mcp-server 0.1.0__py3-none-any.whl

iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/METADATA

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_blazickjp_shell-mcp-server
+Version: 0.1.0
+Summary: Shell MCP Server for Claude AI Application
+Author-email: blazickjp <joe.blazick@yahoo.com>
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# 🖥️ Shell MCP Server
+
+[![PyPI version](https://badge.fury.io/py/shell-mcp-server.svg)](https://badge.fury.io/py/shell-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+> 🚀 Add secure shell command execution capabilities to your AI applications with the Shell MCP Server! Built for the Model Context Protocol.
+
+<a href="https://glama.ai/mcp/servers/@blazickjp/shell-mcp-server">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@blazickjp/shell-mcp-server/badge" alt="Shell Server MCP server" />
+</a>
+
+## ✨ Features
+
+- 🔒 **Secure Execution** - Commands run only in specified directories
+- 🐚 **Multiple Shells** - Support for bash, sh, cmd, powershell
+- ⏱️ **Timeout Control** - Automatic termination of long-running commands
+- 🌍 **Cross-Platform** - Works on both Unix and Windows systems
+- 🛡️ **Safe by Default** - Built-in directory and shell validation
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Using pip
+pip install shell-mcp-server
+
+# Using uv (recommended)
+uv pip install shell-mcp-server
+```
+
+### 🔌 Claude Desktop Integration
+
+Add this to your Claude Desktop config to enable shell command execution:
+
+<details>
+<summary>📝 Click to view configuration</summary>
+
+```json
+{
+    "mcpServers": {
+        "shell-mcp-server": {
+            "command": "uv",
+            "args": [
+                "--directory",
+                "/path/to/shell-mcp-server",
+                "run",
+                "shell-mcp-server",
+                "/path/to/allowed/dir1",
+                "/path/to/allowed/dir2",
+                "--shell", "bash", "/bin/bash",
+                "--shell", "zsh", "/bin/zsh"
+            ]
+        }
+    }
+}
+```
+</details>
+
+## 🎮 Usage Examples
+
+### Basic File Operations
+```python
+# List directory contents
+result = execute_command(
+    command="ls -la",
+    shell="bash",
+    cwd="/path/to/project"
+)
+
+# Find files by pattern
+result = execute_command(
+    command="find . -name '*.py'",
+    shell="bash",
+    cwd="/path/to/project"
+)
+```
+
+### Project Management
+```python
+# Git operations
+result = execute_command(
+    command="git status && git diff",
+    shell="bash",
+    cwd="/path/to/repo"
+)
+
+# Package management
+result = execute_command(
+    command="pip list --outdated",
+    shell="bash",
+    cwd="/path/to/python/project"
+)
+```
+
+### System Information
+```python
+# Resource usage
+result = execute_command(
+    command="df -h && free -h",
+    shell="bash",
+    cwd="/path/to/dir"
+)
+
+# Process monitoring
+result = execute_command(
+    command="ps aux | grep python",
+    shell="bash",
+    cwd="/path/to/dir"
+)
+```
+
+### File Processing
+```python
+# Search file content
+result = execute_command(
+    command="grep -r 'TODO' .",
+    shell="bash",
+    cwd="/path/to/project"
+)
+
+# File manipulation
+result = execute_command(
+    command="awk '{print $1}' data.csv | sort | uniq -c",
+    shell="bash",
+    cwd="/path/to/data"
+)
+```
+
+### Windows-Specific Examples
+```python
+# List processes
+result = execute_command(
+    command="Get-Process | Where-Object {$_.CPU -gt 10}",
+    shell="powershell",
+    cwd="C:\\path\\to\\dir"
+)
+
+# System information
+result = execute_command(
+    command="systeminfo | findstr /B /C:'OS'",
+    shell="cmd",
+    cwd="C:\\path\\to\\dir"
+)
+```
+
+## ⚙️ Configuration
+
+Configure behavior with command-line arguments:
+
+| Argument | Description |
+|----------|-------------|
+| `directories` | 📁 List of allowed directories |
+| `--shell name path` | 🐚 Shell specifications (name and path) |
+
+Environment variables:
+- `COMMAND_TIMEOUT`: ⏱️ Max execution time in seconds (default: 30)
+
+## 🛡️ Security Features
+
+- 🔐 **Directory Isolation**: Commands can only execute in specified directories
+- 🔒 **Shell Control**: Only configured shells are allowed
+- ⏰ **Timeout Protection**: All commands have a configurable timeout
+- 🛑 **Path Validation**: Working directory validation prevents traversal attacks
+- 👤 **Permission Isolation**: Commands run with the same permissions as the server process
+
+## 🛠️ Development
+
+Set up your development environment:
+
+```bash
+# Create and activate virtual environment
+uv venv
+source .venv/bin/activate
+
+# Install development dependencies
+uv pip install -e ".[test]"
+
+# Run tests
+python -m pytest
+
+# Run tests with coverage
+python -m pytest --cov=shell_mcp_server
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to:
+
+- 🐛 Report bugs
+- 💡 Suggest features
+- 🔧 Submit pull requests
+- 📚 Improve documentation
+
+## 📜 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+
+### 🌟 Enhance Your AI with Secure Shell Access! 🌟
+
+Built for the [Model Context Protocol](https://github.com/anthropics/anthropic-tools) | Made with ❤️ by the MCP Community
+
+<details>
+<summary>🎉 Star us on GitHub!</summary>
+<br>
+If you find this tool useful, consider giving it a star! It helps others discover the project.
+</details>
+
+</div>

iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+shell_mcp_server/__init__.py,sha256=ovAp5TM0MqnMk3hUovDs3zW_KWnZcSPJRga7auz8yqo,248
+shell_mcp_server/config.py,sha256=qTFZ64VNXHl5Ie9DvjyKuNkrzGH5toOMbDIYTOx9djI,1525
+shell_mcp_server/server.py,sha256=USlegBvdC_CtbZw_tY3WJFkw_FjGEyv4Y7vanTbjnFM,6699
+iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/METADATA,sha256=ghEJyi8zXTIZc2GMYbVqvW0jn5_NotmvrDHnlS17lDc,5768
+iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=uU33kdLorqZrlsFgrszpUNpbey1hpoeUGanALjvI950,59
+iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/RECORD,,

iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+shell-mcp-server = shell_mcp_server:main

iflow_mcp_blazickjp_shell_mcp_server-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

shell_mcp_server/__init__.py

@@ -0,0 +1,13 @@
+"""Shell MCP Server package."""
+
+from . import server
+import asyncio
+
+
+def main():
+    """Main entry point for the package."""
+    asyncio.run(server.main())
+
+
+# Optionally expose other important items at package level
+__all__ = ["main", "server"]

shell_mcp_server/config.py

@@ -0,0 +1,44 @@
+"""
+Configuration Settings for Shell MCP Server
+========================================
+
+This module defines the settings and configuration options for the shell MCP server.
+"""
+
+from pydantic_settings import BaseSettings
+from pydantic import ConfigDict
+from typing import List, Dict
+import os
+
+
+class Settings(BaseSettings):
+    """
+    Application settings class using pydantic_settings.
+
+    Attributes:
+        APP_NAME (str): Name of the application
+        APP_VERSION (str): Current version of the application
+        COMMAND_TIMEOUT (int): Timeout for command execution in seconds
+        ALLOWED_DIRECTORIES (List[str]): List of directories where commands can be executed
+        ALLOWED_SHELLS (Dict[str, str]): Dictionary of shell names to their paths
+    """
+
+    APP_NAME: str = "shell-mcp-server"
+    APP_VERSION: str = "0.1.0"
+    COMMAND_TIMEOUT: int = 30
+    ALLOWED_DIRECTORIES: List[str] = []
+    ALLOWED_SHELLS: Dict[str, str] = {}
+
+    def __init__(self, directories: List[str], shells: Dict[str, str]):
+        super().__init__()
+        self.ALLOWED_DIRECTORIES = [os.path.abspath(d) for d in directories]
+        self.ALLOWED_SHELLS = shells
+
+    def is_path_allowed(self, path: str) -> bool:
+        """Check if a path is within any of the allowed directories."""
+        abs_path = os.path.abspath(path)
+        return any(
+            abs_path.startswith(allowed_dir) for allowed_dir in self.ALLOWED_DIRECTORIES
+        )
+
+    model_config = ConfigDict(env_file=".env", env_file_encoding="utf-8")

shell_mcp_server/server.py

@@ -0,0 +1,200 @@
+"""
+Shell MCP Server
+==============
+
+This module implements an MCP server that provides secure shell command execution
+within specified working directories using specified shells.
+
+Key Features:
+- Safe command execution in specified directories
+- Supports multiple shell types (bash, sh, cmd, powershell)
+- Command timeout handling
+- Cross-platform support
+- Robust error handling
+"""
+
+import asyncio
+import os
+import sys
+import argparse
+from typing import Dict, Any, List
+import mcp
+import mcp.types as types
+from mcp.server import Server, InitializationOptions, NotificationOptions
+from .config import Settings
+
+
+# Parse command line arguments for directories and shells
+def parse_args() -> tuple[List[str], Dict[str, str]]:
+    """Parse command line arguments for directories and shells."""
+    parser = argparse.ArgumentParser(description="Shell MCP Server")
+    parser.add_argument('directories', nargs='+', help='Allowed directories for command execution')
+    parser.add_argument('--shell', action='append', nargs=2, metavar=('name', 'path'),
+                       help='Shell specification in format: name path')
+    
+    args = parser.parse_args()
+    
+    # Convert shell arguments to dictionary
+    shells = {}
+    if args.shell:
+        shells = {name: path for name, path in args.shell}
+    
+    # Default to system shell if none specified
+    if not shells:
+        if sys.platform == 'win32':
+            shells = {'cmd': 'cmd.exe', 'powershell': 'powershell.exe'}
+        else:
+            shells = {'bash': '/bin/bash', 'sh': '/bin/sh'}
+    
+    return args.directories, shells
+
+
+# Initialize server settings and create server instance - skip arg parsing for tests
+if 'pytest' not in sys.modules:
+    directories, shells = parse_args()
+    settings = Settings(directories=directories, shells=shells)
+else:
+    settings = Settings(directories=['/tmp'], shells={'bash': '/bin/bash'})
+
+server = Server(settings.APP_NAME)
+
+
+async def run_shell_command(shell: str, command: str, cwd: str) -> Dict[str, Any]:
+    """
+    Execute a shell command safely and return its output.
+    
+    Args:
+        shell (str): Name of the shell to use
+        command (str): The command to execute
+        cwd (str): Working directory for command execution
+        
+    Returns:
+        Dict[str, Any]: Command execution results including stdout, stderr, and exit code
+    """
+    if not settings.is_path_allowed(cwd):
+        raise ValueError(f"Directory '{cwd}' is not in the allowed directories list")
+    
+    if shell not in settings.ALLOWED_SHELLS:
+        raise ValueError(f"Shell '{shell}' is not allowed. Available shells: {list(settings.ALLOWED_SHELLS.keys())}")
+    
+    shell_path = settings.ALLOWED_SHELLS[shell]
+    
+    try:
+        if sys.platform == 'win32':
+            shell_cmd = [shell_path, '/c', command] if shell == 'cmd' else [shell_path, '-Command', command]
+        else:
+            shell_cmd = [shell_path, '-c', command]
+
+        process = await asyncio.create_subprocess_exec(
+            *shell_cmd,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+            cwd=cwd
+        )
+
+        try:
+            stdout, stderr = await asyncio.wait_for(
+                process.communicate(), 
+                timeout=settings.COMMAND_TIMEOUT
+            )
+            
+            return {
+                "stdout": stdout.decode() if stdout else "",
+                "stderr": stderr.decode() if stderr else "",
+                "exit_code": process.returncode,
+                "command": command,
+                "shell": shell,
+                "cwd": cwd
+            }
+
+        except asyncio.TimeoutError:
+            try:
+                process.kill()
+                await process.wait()
+            except ProcessLookupError:
+                pass
+            raise TimeoutError(f"Command execution timed out after {settings.COMMAND_TIMEOUT} seconds")
+
+    except TimeoutError:
+        raise
+    except Exception as e:
+        return {
+            "stdout": "",
+            "stderr": str(e),
+            "exit_code": -1,
+            "command": command,
+            "shell": shell,
+            "cwd": cwd
+        }
+
+
+@server.list_tools()
+async def list_tools() -> List[types.Tool]:
+    """List available shell tools."""
+    return [
+        types.Tool(
+            name="execute_command",
+            description="Execute a shell command in a specified directory using a specified shell",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "command": {
+                        "type": "string",
+                        "description": "The shell command to execute",
+                    },
+                    "shell": {
+                        "type": "string",
+                        "description": f"Shell to use for execution. Available: {list(settings.ALLOWED_SHELLS.keys())}",
+                    },
+                    "cwd": {
+                        "type": "string",
+                        "description": "Working directory for command execution",
+                    },
+                },
+                "required": ["command", "shell", "cwd"],
+            },
+        )
+    ]
+
+
+@server.call_tool()
+async def call_tool(name: str, arguments: Dict[str, Any]) -> List[types.TextContent]:
+    """
+    Handle tool calls for shell command execution.
+    
+    Args:
+        name (str): The name of the tool to call (must be 'execute_command')
+        arguments (Dict[str, Any]): Tool arguments including 'command', 'shell', and 'cwd'
+        
+    Returns:
+        List[types.TextContent]: The command execution results or error message
+    """
+    if name != "execute_command":
+        return [types.TextContent(type="text", text=f"Error: Unknown tool {name}")]
+
+    command = arguments["command"]
+    shell = arguments["shell"]
+    cwd = arguments["cwd"]
+
+    try:
+        result = await run_shell_command(shell, command, cwd)
+        return [types.TextContent(type="text", text=str(result))]
+    except Exception as e:
+        return [types.TextContent(type="text", text=f"Error: {str(e)}")]
+
+
+async def main():
+    """Main entry point for the shell MCP server."""
+    async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            InitializationOptions(
+                server_name=settings.APP_NAME,
+                server_version=settings.APP_VERSION,
+                capabilities=server.get_capabilities(
+                    notification_options=NotificationOptions(),
+                    experimental_capabilities={},
+                ),
+            ),
+        )