tjariy-code-interpreter-mcp-server
An MCP (Model Context Protocol) server that provides secure code execution capabilities using AWS Bedrock AgentCore's CodeInterpreter.
Features
- Execute Python, JavaScript, and TypeScript code in a secure sandbox
- Run shell commands
- File operations (read, write, list, remove)
- Session management (auto-managed by default)
Prerequisites
- Node.js 20+
- AWS credentials configured (via environment variables, AWS profile, or IAM role)
- Access to AWS Bedrock AgentCore CodeInterpreter service
Installation
npm install
npm run buildConfiguration
Set the AWS region via environment variable (default: us-west-2):
export AWS_REGION=us-west-2AWS credentials can be configured via:
- Environment variables (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY) - AWS credentials file (
~/.aws/credentials) - IAM role (when running on AWS infrastructure)
Usage
Running the Server
# Production
npm start
# Development
npm run devClaude Desktop Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"code-interpreter": {
"command": "npx",
"args": ["-y", "tjariy-code-interpreter-mcp-server"],
"env": {
// Optional: defaults to "us-west-2"
"AWS_REGION": "us-west-2",
// Optional: defaults to "default" profile, or uses IAM role if on AWS
"AWS_PROFILE": "your-profile"
}
}
}
}Available Tools
| Tool | Description | |------|-------------| | execute_code | Execute Python/JavaScript/TypeScript code in sandbox | | execute_command | Run shell commands | | read_files | Read file contents from sandbox | | write_files | Write files to sandbox | | list_files | List directory contents | | remove_files | Delete files | | start_session | Create a new interpreter session | | stop_session | Terminate current session | | get_session | Get session information | | list_sessions | List all sessions |
Examples
Once configured with Claude Desktop, you can ask Claude to:
- "Run this Python code:
print('Hello, World!')" - "Create a file called test.py with a fibonacci function"
- "List all files in the current directory"
- "Execute a shell command to check the Python version"
License
MIT
