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 build

Configuration

Set the AWS region via environment variable (default: us-west-2):

export AWS_REGION=us-west-2

AWS 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 dev

Claude 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