feat: Enhance tool detail loading and execution handling in MCP Tool Inspector

Author: tercel

CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-02-24
+
+### Added
+
+- **MCP Tool Inspector (F-026)**: Optional browser-based UI for inspecting and testing MCP tools, mounted at `/inspector` when `explorer=True`. Includes 4 HTTP endpoints (`GET /inspector/`, `GET /inspector/tools`, `GET /inspector/tools/<name>`, `POST /inspector/tools/<name>/call`), a self-contained HTML/CSS/JS page with no external dependencies, configurable `inspector_prefix`, and `allow_execute` guard (default `False`). HTTP transports only; silently ignored for stdio.
+- **CLI Inspector flags**: `--explorer`, `--inspector-prefix`, and `--allow-execute` arguments.
+- **Inspector UI: proactive execution status detection**: The Inspector probes execution status on page load via a lightweight POST to `/tools/__probe__/call`, so the "Tool execution is disabled" message appears immediately instead of requiring a user click first.
+- **Inspector UI: URL-safe tool name encoding**: Tool names in fetch URLs are wrapped with `encodeURIComponent()` to prevent malformed URLs when tool names contain special characters.
+- **Inspector UI: error handling on tool detail fetch**: `.catch()` handler on the `loadDetail` fetch chain displays network errors in the detail panel instead of silently swallowing them.
+
+## [0.4.0] - 2026-02-23
+
+### Added
+
+- **Resource handlers**: `MCPServerFactory.register_resource_handlers()` for serving documentation resources via MCP.
+- **CI workflow**: GitHub Actions CI pipeline and `CODEOWNERS` file.
+- **Missing error codes**: Added `MODULE_EXECUTE_ERROR` and `GENERAL_INVALID_INPUT` to error codes constants.
+- **serve() parameter tests**: Comprehensive test suite for `serve()` parameter validation.
+- **Metrics endpoint tests**: Dedicated test suite for Prometheus `/metrics` endpoint.
+
+### Changed
+
+- **Version management**: Consolidated version into `__init__.__version__`, removed `_version.py`.
+
+### Fixed
+
+- **Cache configuration**: Removed unnecessary cache configuration from Python setup step.
+- **Code formatting**: Improved linting checks in CI workflow, factory, router, and test files.
+
+### Refactored
+
+- **Import cleanup**: Removed unused imports across multiple test files; reordered imports in MCPServer for consistency.
+- **Code structure**: General readability and maintainability improvements.
+
 ## [0.3.0] - 2026-02-22
 
 ### Added
@@ -66,6 +100,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Filtering**: `tags` and `prefix` parameters for selective module exposure.
 - **260 tests**: Unit, integration, E2E, performance, and security test suites.
 
+[0.5.0]: https://github.com/aipartnerup/apcore-mcp-python/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/aipartnerup/apcore-mcp-python/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/aipartnerup/apcore-mcp-python/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/aipartnerup/apcore-mcp-python/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/aipartnerup/apcore-mcp-python/releases/tag/v0.1.0

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apcore-mcp"
-version = "0.4.0"
+version = "0.5.0"
 description = "Automatic MCP Server & OpenAI Tools Bridge for apcore"
 readme = "README.md"
 license = "Apache-2.0"

src/apcore_mcp/__init__.py

@@ -49,7 +49,7 @@
     "MCP_ELICIT_KEY",
 ]
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"
 
 logger = logging.getLogger(__name__)
 

src/apcore_mcp/inspector/html.py

@@ -117,11 +117,18 @@
         li.onclick = function() { loadDetail(t.name); };
         toolsEl.appendChild(li);
       });
+      fetch(base + '/tools/__probe__/call', {
+        method: 'POST',
+        headers: {'Content-Type': 'application/json'},
+        body: '{}'
+      }).then(function(r) {
+        executeEnabled = r.status !== 403;
+      }).catch(function() {});
     })
     .catch(function(e) { loadingEl.textContent = 'Error: ' + e; });
 
   function loadDetail(name) {
-    fetch(base + '/tools/' + name)
+    fetch(base + '/tools/' + encodeURIComponent(name))
       .then(function(r) { return r.json(); })
       .then(function(d) {
         detailEl.className = 'detail active';
@@ -158,6 +165,10 @@
             'Tool execution is disabled. ' +
             'Launch with --allow-execute to enable.</p>';
         }
+      })
+      .catch(function(e) {
+        detailEl.className = 'detail active';
+        detailEl.innerHTML = '<p class="result-error">Failed to load tool details: ' + esc(e.message) + '</p>';
       });
   }
 
@@ -179,7 +190,7 @@
     btn.textContent = 'Executing...';
     resultArea.innerHTML = '';
 
-    fetch(base + '/tools/' + name + '/call', {
+    fetch(base + '/tools/' + encodeURIComponent(name) + '/call', {
       method: 'POST',
       headers: {'Content-Type': 'application/json'},
       body: JSON.stringify(inputs)