mcpassistant/mcp-inspector-assistant
If you are the rightful owner of mcp-inspector-assistant and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
MCP Inspector Assistant is a robust server tool that leverages the official MCP Inspector to facilitate server testing, debugging, and validation.
MCP Inspector Assistant
A powerful MCP server that wraps the official MCP Inspector to provide programmatic access to server testing, debugging, and validation capabilities.
Features
- Server Inspection: Start the MCP Inspector UI or CLI for any MCP server
- Tool Testing: Test individual tools with specific arguments
- Protocol Validation: Verify MCP protocol compliance
- Capability Discovery: List all tools, resources, and prompts of a server
- Debug Mode: Run servers with debug output and capture logs
- Automatic Updates: Uses the official inspector package for latest features
Installation
npm install
Usage
As MCP Server (stdio)
npm start
As HTTP Service
npm run http
The HTTP service runs on port 8206 by default (configurable via MCP_INSPECTOR_PORT
).
Available Tools
start_inspector
Start the MCP Inspector UI or CLI for a specific server.
{
"tool": "start_inspector",
"arguments": {
"serverPath": "/path/to/mcp-server/standalone.js",
"port": 5173,
"mode": "ui"
}
}
stop_inspector
Stop any running MCP Inspector instance.
{
"tool": "stop_inspector",
"arguments": {}
}
test_tool
Test a specific tool on an MCP server.
{
"tool": "test_tool",
"arguments": {
"serverPath": "/path/to/server.js",
"toolName": "myTool",
"arguments": {
"param1": "value1"
}
}
}
list_server_capabilities
List all capabilities (tools) of an MCP server.
{
"tool": "list_server_capabilities",
"arguments": {
"serverPath": "/path/to/server.js"
}
}
validate_protocol
Validate that a server follows MCP protocol correctly.
{
"tool": "validate_protocol",
"arguments": {
"serverPath": "/path/to/server.js",
"checks": ["initialization", "tools"]
}
}
debug_server
Run a server with debug output and capture logs.
{
"tool": "debug_server",
"arguments": {
"serverPath": "/path/to/server.js",
"duration": 30
}
}
Examples
Testing a Gateway Assistant Tool
# Using HTTP API
curl -X POST http://localhost:8206/tools/test_tool \
-H "Content-Type: application/json" \
-d '{
"serverPath": "/path/to/mcp-gateway-assistant/standalone.js",
"toolName": "check_service_health",
"arguments": {
"services": ["secrets", "logging"]
}
}'
Starting Inspector UI
# Start inspector for secrets assistant
curl -X POST http://localhost:8206/tools/start_inspector \
-H "Content-Type: application/json" \
-d '{
"serverPath": "/path/to/mcp-secrets-assistant/standalone.js",
"mode": "ui"
}'
Testing
# Test MCP mode
npm test
# Test HTTP mode
npm run test:http
Integration with Claude Desktop
Add to your claude_desktop_config.json
:
{
"mcpServers": {
"inspector-assistant": {
"command": "node",
"args": [
"/path/to/mcp-inspector-assistant/standalone.js"
],
"env": {}
}
}
}
Dependencies
This assistant uses the official @modelcontextprotocol/inspector
package, ensuring compatibility with the latest MCP Inspector features and updates.