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

``bash
npm install
npm run build
`

Configuration

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

`bash
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

$3

`bash


Production

npm start

Development

npm run dev
`

$3

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

`jsonc
{
"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