Merge pull request #11 from bazinga012/working_dockerfile

README.md updated

Author: jefcoder

README.md

@@ -1,13 +1,14 @@
 # MCP Code Executor
 [![smithery badge](https://smithery.ai/badge/@bazinga012/mcp_code_executor)](https://smithery.ai/server/@bazinga012/mcp_code_executor)
 
-The MCP Code Executor is an MCP server that allows LLMs to execute Python code within a specified Python environment. This enables LLMs to run code with access to libraries and dependencies defined in the environment.
+The MCP Code Executor is an MCP server that allows LLMs to execute Python code within a specified Python environment. This enables LLMs to run code with access to libraries and dependencies defined in the environment. It also supports incremental code generation for handling large code blocks that may exceed token limits.
 
 <a href="https://glama.ai/mcp/servers/45ix8xode3"><img width="380" height="200" src="https://glama.ai/mcp/servers/45ix8xode3/badge" alt="Code Executor MCP server" /></a>
 
 ## Features
 
 - Execute Python code from LLM prompts
+- Support for incremental code generation to overcome token limitations
 - Run code within a specified environment (Conda, virtualenv, or UV virtualenv)
 - Install dependencies when needed
 - Check if packages are already installed
@@ -115,7 +116,7 @@ To configure the MCP Code Executor server, add the following to your MCP servers
 The MCP Code Executor provides the following tools to LLMs:
 
 ### 1. `execute_code`
-Executes Python code in the configured environment.
+Executes Python code in the configured environment. Best for short code snippets.
 ```json
 {
   "name": "execute_code",
@@ -169,12 +170,69 @@ Gets the current environment configuration.
 }
 ```
 
+### 6. `initialize_code_file`
+Creates a new Python file with initial content. Use this as the first step for longer code that may exceed token limits.
+```json
+{
+  "name": "initialize_code_file",
+  "arguments": {
+    "content": "def main():\n    print('Hello, world!')\n\nif __name__ == '__main__':\n    main()",
+    "filename": "my_script"
+  }
+}
+```
+
+### 7. `append_to_code_file`
+Appends content to an existing Python code file. Use this to add more code to a file created with initialize_code_file.
+```json
+{
+  "name": "append_to_code_file",
+  "arguments": {
+    "file_path": "/path/to/code/storage/my_script_abc123.py",
+    "content": "\ndef another_function():\n    print('This was appended to the file')\n"
+  }
+}
+```
+
+### 8. `execute_code_file`
+Executes an existing Python file. Use this as the final step after building up code with initialize_code_file and append_to_code_file.
+```json
+{
+  "name": "execute_code_file",
+  "arguments": {
+    "file_path": "/path/to/code/storage/my_script_abc123.py"
+  }
+}
+```
+
+### 9. `read_code_file`
+Reads the content of an existing Python code file. Use this to verify the current state of a file before appending more content or executing it.
+```json
+{
+  "name": "read_code_file",
+  "arguments": {
+    "file_path": "/path/to/code/storage/my_script_abc123.py"
+  }
+}
+```
+
 ## Usage
 
 Once configured, the MCP Code Executor will allow LLMs to execute Python code by generating a file in the specified `CODE_STORAGE_DIR` and running it within the configured environment.
 
 LLMs can generate and execute code by referencing this MCP server in their prompts.
 
+### Handling Large Code Blocks
+
+For larger code blocks that might exceed LLM token limits, use the incremental code generation approach:
+
+1. **Initialize a file** with the basic structure using `initialize_code_file`
+2. **Add more code** in subsequent calls using `append_to_code_file`
+3. **Verify the file content** if needed using `read_code_file`
+4. **Execute the complete code** using `execute_code_file`
+
+This approach allows LLMs to write complex, multi-part code without running into token limitations.
+
 ## Backward Compatibility
 
 This package maintains backward compatibility with earlier versions. Users of previous versions who only specified a Conda environment will continue to work without any changes to their configuration.