docs: add badges, Docker quickstart, new tools, update tool count to 20

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: HanSur94

README.md

@@ -13,6 +13,18 @@
   <a href="https://github.com/HanSur94/matlab-mcp-server-python/wiki">Wiki</a>
 </p>
 
+<p align="center">
+  <a href="https://github.com/HanSur94/matlab-mcp-server-python/actions/workflows/ci.yml">
+    <img src="https://github.com/HanSur94/matlab-mcp-server-python/actions/workflows/ci.yml/badge.svg" alt="CI">
+  </a>
+  <a href="https://pypi.org/project/matlab-mcp-python/">
+    <img src="https://img.shields.io/pypi/v/matlab-mcp-python" alt="PyPI">
+  </a>
+  <a href="https://pypi.org/project/matlab-mcp-python/">
+    <img src="https://img.shields.io/pypi/pyversions/matlab-mcp-python" alt="Python">
+  </a>
+</p>
+
 ---
 
 A Python MCP server that connects **any AI agent** (Claude, Cursor, Copilot, custom agents) to a shared MATLAB installation. Execute code, discover toolboxes, check code quality, get interactive Plotly plots, and run long simulations — all through [MCP](https://modelcontextprotocol.io/).
@@ -56,6 +68,10 @@ pip install .
 ### Install the server
 
 ```bash
+# Option 1: Install from PyPI
+pip install matlab-mcp-python
+
+# Option 2: Install from source
 git clone https://github.com/HanSur94/matlab-mcp-server-python.git
 cd matlab-mcp-server-python
 pip install -e ".[dev]"
@@ -105,6 +121,26 @@ Add to `.cursor/mcp.json` in your project:
 }
 ```
 
+### Run with Docker
+
+```bash
+# Build the image
+docker build -t matlab-mcp .
+
+# Run with your MATLAB mounted
+docker run -p 8765:8765 -p 8766:8766 \
+  -v /path/to/MATLAB:/opt/matlab:ro \
+  -e MATLAB_MCP_POOL_MATLAB_ROOT=/opt/matlab \
+  matlab-mcp
+
+# Or use docker-compose (edit docker-compose.yml to set your MATLAB path)
+docker compose up
+```
+
+> **Note:** The Docker image does not include MATLAB. You must mount your own MATLAB installation.
+
+> **Upgrading?** If you previously installed as `matlab-mcp-server`, uninstall first: `pip uninstall matlab-mcp-server && pip install matlab-mcp-python`
+
 ## Examples
 
 ### Basic: Run MATLAB Code
@@ -235,6 +271,14 @@ Now the agent can call `analyze_signal` or `train_model` directly — with full
 | `delete_file` | `filename: str` | Delete a session file |
 | `list_files` | — | List files in the session directory |
 
+### File Reading
+
+| Tool | Parameters | Description |
+|------|-----------|-------------|
+| `read_script` | `filename: str` | Read a MATLAB `.m` script file as text |
+| `read_data` | `filename: str, format: str` | Read data files (`.mat`, `.csv`, `.json`, `.txt`, `.xlsx`). `format`: `summary` or `raw` |
+| `read_image` | `filename: str` | Read image files (`.png`, `.jpg`, `.gif`) — renders inline in agent UIs |
+
 ### Admin
 
 | Tool | Parameters | Description |
@@ -558,7 +602,7 @@ AI Agent (Claude, Cursor, etc.)
        ▼
 ┌──────────────────────────────────────────────────────────┐
 │   MCP Server (FastMCP 2.x)                                │
-│   17 tools + custom tools                                 │
+│   20 tools + custom tools                                 │
 │   Session manager  │  Security validator  │  Formatter    │
 └──────────┬───────────────────────────────┬───────────────┘
            │                               │

wiki/Architecture.md

@@ -9,7 +9,7 @@ AI Agent (Claude, Cursor, Copilot, etc.)
        ▼
 ┌─────────────────────────────────┐
 │   MCP Server (FastMCP)           │
-│   ├─ 17 built-in tools           │
+│   ├─ 20 built-in tools           │
 │   ├─ Custom tools (from YAML)    │
 │   ├─ Session manager             │
 │   ├─ Security validator          │
@@ -43,7 +43,7 @@ AI Agent (Claude, Cursor, Copilot, etc.)
 
 The entry point. Uses [FastMCP](https://github.com/jlowin/fastmcp) to handle MCP protocol details. Responsibilities:
 
-- Register all 17 tools + custom tools
+- Register all 20 tools + custom tools
 - Manage server lifecycle (startup, shutdown, drain)
 - Route tool calls to implementation modules
 - Run background tasks (health checks, cleanup)

wiki/Home.md

@@ -6,7 +6,7 @@ Welcome to the **MATLAB MCP Server** wiki! This server connects any AI agent to
 
 - **[[Installation]]** — Prerequisites, MATLAB Engine API, server setup
 - **[[Configuration]]** — Full YAML config reference with all options
-- **[[MCP Tools Reference]]** — All 17 built-in tools with parameters and examples
+- **[[MCP Tools Reference]]** — All 20 built-in tools with parameters and examples
 - **[[Custom Tools]]** — Expose your own `.m` functions as AI-callable tools
 - **[[Examples]]** — Ready-to-run MATLAB examples for common tasks
 - **[[Architecture]]** — System design, engine pool, async jobs, session model

wiki/MCP-Tools-Reference.md

@@ -1,6 +1,6 @@
 # MCP Tools Reference
 
-The server exposes 17 built-in tools plus any custom tools defined in your `custom_tools.yaml`.
+The server exposes 20 built-in tools plus any custom tools defined in your `custom_tools.yaml`.
 
 ## Code Execution
 
@@ -188,6 +188,41 @@ Get the current engine pool status.
 }
 ```
 
+## File Reading
+
+### `read_script`
+
+Read a MATLAB `.m` script file from the session temp directory.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `filename` | string | yes | `.m` file to read |
+
+Returns the file content as inline text.
+
+### `read_data`
+
+Read a data file from the session temp directory.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `filename` | string | yes | Data file to read |
+| `format` | string | no | `summary` (default) or `raw` |
+
+**Behavior by file type:**
+- `.mat` summary: shows variable names, sizes, types via MATLAB `whos`
+- `.mat` raw: returns base64-encoded content
+- `.csv`, `.txt`, `.json`: returns text content
+- `.xlsx`: returns base64-encoded content
+
+### `read_image`
+
+Read an image file from the session temp directory. Returns an inline image that renders in agent UIs.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `filename` | string | yes | Image file (`.png`, `.jpg`, `.gif`) |
+
 ## Monitoring
 
 ### `get_server_metrics`

wiki/SETUP_WIKI.md

@@ -29,7 +29,7 @@ git push origin master
 - **Home.md** — Main page with navigation
 - **Installation.md** — Prerequisites, setup, agent integration
 - **Configuration.md** — Full YAML config reference
-- **MCP-Tools-Reference.md** — All 17 tools with parameters
+- **MCP-Tools-Reference.md** — All 20 tools with parameters
 - **Custom-Tools.md** — How to expose .m functions
 - **Examples.md** — Ready-to-run MATLAB examples
 - **Architecture.md** — System design and data flow