Package Exports

tjariy-code-interpreter-mcp-server
tjariy-code-interpreter-mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tjariy-code-interpreter-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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