About vimble-mcp
vimble-mcp is an MCP server for running JavaScript code with Vimble. It is intended for MCP clients that need sandboxed execution, with a default 10-second time limit and an optional debug mode.
Key features
- 01Run JavaScript in a sandbox
- 02Limit execution time
- 03Enable verbose debug logging
Use cases
- 01Execute JavaScript code from an MCP client
- 02Stop scripts that exceed the time limit
- 03Inspect execution through debug logs
MCP support
The server exposes the `execute_javascript` tool to MCP clients, accepting code and optional context and returning output or errors.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
1Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | Yes | JavaScript code to execute |
| context | object | No | Optional context to inject into the execution environment |
| timeout | number | No | Timeout in milliseconds |
Details
From the project READMEvimble-mcp
A Model Context Protocol (MCP) server for executing JavaScript code using Vimble.
Features
- Execute arbitrary JavaScript code in a sandboxed environment.
- Time-limited execution (10 second default) to prevent runaway scripts.
- Debug mode for verbose logging.
Installation
Prerequisites
- node/npx
Installation
Add the following to your MCP JSON configuration
{
"mcpServers": {
...
"vimble-mcp": {
"command": "npx",
"args": [ "-y", "vimble-mcp"]
}
}
}
Usage
Tool: execute_javascript
- Name: execute_javascript
- Description: Execute JavaScript code. Use
console.logto emit output. - Input Schema:
{
code: string; // JavaScript code to execute
context?: object; // Optional context injected into the execution environment
}
- Response:
{
content: [{ type: "text", text: string }];
success: boolean;
error?: string;
}
License
This project is licensed under the MIT License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.