TCL MCP Server

A Model Context Protocol (MCP) server that enables AI agents to execute TCL scripts and manage MCP tool ecosystems. Built with safety and developer experience in mind.

Quick Start

# Install and run (safe mode with Molt runtime)
cargo install tcl-mcp-server
tcl-mcp-server

# Or build from source
git clone https://github.com/cyberdione/mcp-tcl-udf-server
cd mcp-tcl-udf-server
cargo build --release
./target/release/tcl-mcp-server

# OPTIONAL: Build with full unsafe TCL runtime (requires system TCL installation)
# cargo build --release --features tcl

What It Does

• Execute TCL Scripts: Run TCL code through MCP with intelligent safety controls
• Manage MCP Ecosystem: Add, remove, and orchestrate other MCP servers
• Safe by Default: Uses Molt (memory-safe TCL) with sandboxed execution
• Tool Management: Create, version, and organize custom tools
• Cross-Platform: Works on Linux, macOS, and Windows

Runtime Options

Choose between two TCL runtime implementations:

🔒 Molt Runtime (Default - Safe)

• Memory-safe: Written in Rust with built-in safety guarantees
• Sandboxed: No file I/O, no system commands, no network access
• Subset: Core TCL functionality for data processing and algorithms
• Recommended: For production use and untrusted environments
• Documentation: Molt TCL Book

⚠️ TCL Runtime (Complete - Unsafe)

• Full functionality: Complete TCL language with all features
• System access: File I/O, system commands, network operations
• Powerful: Advanced scripting capabilities and system integration
• Risky: Requires trusted environment and careful input validation
• Documentation: Official TCL Documentation

Core Features

🔒 Safety First

• Restricted Mode (default): Safe TCL execution with limited commands
• Privileged Mode: Full TCL access for advanced use cases
• Runtime Selection: Choose between safe (Molt) and complete (TCL) implementations

🛠️ MCP Management

# Add external MCP servers
tcl-mcp-server mcp add claude-flow "Claude Flow" -- npx claude-flow@alpha mcp start

# List all servers
tcl-mcp-server mcp list

# Test connectivity
tcl-mcp-server mcp ping claude-flow

📦 Tool Organization

Tools are organized using a namespace system with MCP-compatible naming:

• bin__tcl_execute - Execute TCL scripts
• user__alice__utils__reverse_string - User-created tools
• mcp__context7__get_library_docs - External MCP server tools

Usage

Running the Server

Default (Read-only mode)

tcl-mcp-server

Privileged Mode (Save/store scripts)

tcl-mcp-server --privileged
# or use the admin wrapper
tcl-mcp-server-admin

Essential Commands

# Execute TCL directly
tcl-mcp-server run tcl_execute '{"script": "expr {2 + 2}"}'

# List available tools
tcl-mcp-server list

# Get tool information
tcl-mcp-server info tcl_execute

# Manage MCP servers
tcl-mcp-server mcp add my-server "My Server" -- node server.js
tcl-mcp-server mcp remove my-server

MCP Client Integration

Claude Desktop

{
  "mcpServers": {
    "tcl": {
      "command": "/path/to/tcl-mcp-server",
      "args": ["--runtime", "molt", "--privileged"]
    }
  }
}

Claude Code

claude mcp add tcl /path/to/tcl-mcp-server

Built-in Tools

Core Tools (Always Available)

bin__tcl_execute - Execute TCL scripts

{
  "script": "set x 5; set y 10; expr {$x + $y}"
}

bin__list_tools - List available tools

{
  "namespace": "user",
  "filter": "utils*"
}

docs__molt_book - Access TCL documentation

{
  "topic": "basic_syntax"

... [View full README on GitHub](https://github.com/cyberdione/mcp-tcl-udf-server#readme)