MCP Tcl Udf Server

🚀 TCL MCP Server

AIエージェントがTCLスクリプトを実行し、MCPツールエコシステムを管理できるようにするモデルコンテキストプロトコル（MCP）サーバーです。安全性と開発者体験を重視して構築されています。

🚀 クイックスタート

# インストールと実行（Moltランタイムのセーフモード）
cargo install tcl-mcp-server
tcl-mcp-server

# またはソースからビルド
git clone https://github.com/cyberdione/mcp-tcl-udf-server
cd mcp-tcl-udf-server
cargo build --release
./target/release/tcl-mcp-server

# オプション: 完全な不安全なTCLランタイムでビルド（システムのTCLインストールが必要）
# cargo build --release --features tcl

✨ 主な機能

• TCLスクリプトの実行：MCPを通じて、高度な安全制御を伴ってTCLコードを実行します。
• MCPエコシステムの管理：他のMCPサーバーの追加、削除、および調整を行います。
• デフォルトで安全：サンドボックス化された実行環境で、Molt（メモリ安全なTCL）を使用します。
• ツール管理：カスタムツールの作成、バージョン管理、および整理を行います。
• クロスプラットフォーム対応：Linux、macOS、およびWindowsで動作します。

🔧 ランタイムオプション

2つのTCLランタイム実装から選択できます。

🔒 Moltランタイム（デフォルト - 安全）

• メモリ安全：Rustで書かれ、組み込みの安全保証があります。
• サンドボックス化：ファイルI/O、システムコマンド、ネットワークアクセスができません。
• サブセット：データ処理とアルゴリズムのための核心的なTCL機能を備えています。
• 推奨：本番環境や信頼できない環境での使用に適しています。
• ドキュメント：Molt TCL Book

⚠️ TCLランタイム（完全 - 不安全）

• 完全な機能：すべての機能を備えた完全なTCL言語を使用できます。
• システムアクセス：ファイルI/O、システムコマンド、ネットワーク操作が可能です。
• 強力：高度なスクリプト機能とシステム統合が可能です。
• リスクあり：信頼できる環境と注意深い入力検証が必要です。
• ドキュメント：公式TCLドキュメント

🔧 技術詳細

🔒 安全を第一に

• 制限モード（デフォルト）：制限されたコマンドで安全なTCL実行を行います。
• 特権モード：高度なユースケースでの完全なTCLアクセスを提供します。
• ランタイム選択：安全な（Molt）と完全な（TCL）実装の間で選択できます。

🛠️ MCP管理

# 外部のMCPサーバーを追加
tcl-mcp-server mcp add claude-flow "Claude Flow" -- npx claude-flow@alpha mcp start

# すべてのサーバーをリスト表示
tcl-mcp-server mcp list

# 接続性をテスト
tcl-mcp-server mcp ping claude-flow

📦 ツールの整理

ツールは、MCP互換の命名規則を持つ名前空間システムを使用して整理されます。

• bin__tcl_execute - TCLスクリプトを実行します。
• user__alice__utils__reverse_string - ユーザーが作成したツールです。
• mcp__context7__get_library_docs - 外部のMCPサーバーツールです。

💻 使用例

サーバーの実行

デフォルト（読み取り専用モード）

tcl-mcp-server

特権モード（スクリプトの保存/格納）

tcl-mcp-server --privileged
# または管理者ラッパーを使用
tcl-mcp-server-admin

必須コマンド

# 直接TCLを実行
tcl-mcp-server run tcl_execute '{"script": "expr {2 + 2}"}'

# 利用可能なツールをリスト表示
tcl-mcp-server list

# ツールの情報を取得
tcl-mcp-server info tcl_execute

# MCPサーバーを管理
tcl-mcp-server mcp add my-server "My Server" -- node server.js
tcl-mcp-server mcp remove my-server

MCPクライアントの統合

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

📚 ドキュメント

組み込みツール

コアツール（常に利用可能）

bin__tcl_execute - TCLスクリプトを実行します。

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

bin__list_tools - 利用可能なツールをリスト表示します。

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

docs__molt_book - TCLドキュメントにアクセスします。

{
  "topic": "basic_syntax"
}

管理ツール（特権モードのみ）

sbin__tcl_tool_add - カスタムツールを作成します。

{
  "user": "alice",
  "package": "utils",
  "name": "reverse_string",
  "version": "1.0",
  "description": "文字列を反転する",
  "script": "return [string reverse $text]",
  "parameters": [
    {
      "name": "text",
      "description": "反転するテキスト",
      "required": true,
      "type_name": "string"
    }
  ]
}

sbin__mcp_add - プログラムでMCPサーバーを追加します。

{
  "id": "context7",
  "name": "Context7 Server",
  "command": "npx",
  "args": ["@modelcontextprotocol/server-everything"],
  "auto_start": true
}

コンパイルとランタイム設定

ビルドオプション

サーバーは、コンパイル時に選択する必要がある2つのTCLランタイム実装をサポートしています。

デフォルトビルド（Moltランタイム - 安全）

# Moltランタイムのみでビルド（推奨）
cargo build --release

# 生成されたバイナリはデフォルトでMoltを使用
./target/release/tcl-mcp-server

TCLランタイムでビルド（完全だが不安全）

# 完全なTCLランタイムでビルド（システムのTCLインストールが必要）
cargo build --release --no-default-features --features tcl

# 生成されたバイナリは完全なTCLを使用
./target/release/tcl-mcp-server

両方のランタイムでビルド

# 両方のランタイムを使用可能にビルド（最大の柔軟性）
cargo build --release --features molt,tcl

# 起動時にランタイムを選択
./target/release/tcl-mcp-server --runtime molt   # 安全モード
./target/release/tcl-mcp-server --runtime tcl    # 完全モード

ランタイム選択（複数ランタイムビルド）

複数のランタイムでビルドされた場合、起動時に選択できます。

# コマンドラインで選択
tcl-mcp-server --runtime molt          # 安全: Moltランタイム
tcl-mcp-server --runtime tcl           # 不安全: 完全なTCLランタイム

# 環境変数で選択
export TCL_MCP_RUNTIME=molt
tcl-mcp-server

# 優先順位: CLI引数 > 環境変数 > デフォルト（Molt）

システム要件

Moltランタイム（デフォルト）の場合

• Rustツールチェーンのみ
• 外部依存関係なし
• すべてのプラットフォームで動作

TCLランタイムの場合

• システムのTCLインストールが必要（8.6+）
• コンパイルに開発ヘッダーが必要
• プラットフォーム固有のセットアップ:

  # Ubuntu/Debian
  sudo apt-get install tcl-dev
  
  # macOS
  brew install tcl-tk
  
  # Windows
  # https://www.tcl-lang.org/software/tcltk/ からTCLをインストール
  

事前ビルド済みラッパースクリプト

ビルドプロセスで自動的に便利なラッパーが生成されます。

# ビルド中に生成
./target/release/tcl-mcp-server-admin      # 特権モード
./target/release/tcl-mcp-server-molt       # 強制的にMoltランタイムを使用
./target/release/tcl-mcp-server-admin-molt # 特権 + Molt
./target/release/tcl-mcp-server-ctcl       # 強制的にTCLランタイムを使用
./target/release/tcl-mcp-server-admin-ctcl # 特権 + TCL

MCPサーバーの管理

サーバーの追加

# 基本的なサーバー
tcl-mcp-server mcp add my-server "My Server" -- node server.js

# 環境変数を指定
tcl-mcp-server mcp add my-server "My Server" \
  --env "NODE_ENV=production" \
  --env "API_KEY=secret" \
  -- node server.js

# カスタムタイムアウトとリトライ設定
tcl-mcp-server mcp add my-server "My Server" \
  --timeout-ms 60000 \
  --max-retries 5 \
  -- node server.js

サーバー情報

# すべてのサーバーをリスト表示
tcl-mcp-server mcp list

# 詳細表示
tcl-mcp-server mcp list --detailed

# サーバーの詳細
tcl-mcp-server mcp info my-server

接続管理

# 手動で接続
tcl-mcp-server mcp connect my-server

# 接続性をテスト
tcl-mcp-server mcp ping my-server

# 切断
tcl-mcp-server mcp disconnect my-server

# サーバーを削除
tcl-mcp-server mcp remove my-server

セキュリティモデル

デフォルトのセキュリティ（推奨）

• 制限モード：必須のツールのみが利用可能です。
• Moltランタイム：メモリ安全でサンドボックス化された実行環境（Moltドキュメントを参照）。
• ファイルI/Oなし：不正なファイルアクセスを防止します。
• システムコマンドなし：システムレベルの操作をブロックします。

特権モード

⚠️ 注意して使用してください

• 完全なTCL言語へのアクセスが可能です。
• ツール管理機能があります。
• システムレベルの操作が可能です（特にTCLランタイムの場合）。
• 信頼できる環境でのみ推奨されます。
• TCLランタイムを使用する場合：完全なシステムアクセスが可能です（TCLドキュメントを参照）。

アーキテクチャ

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  AI Agent   ├────►│  MCP Server  ├────►│TCL Executor │
│  (Claude)   │     │  (JSON-RPC)  │     │  (Molt)     │
└─────────────┘     └──────────────┘     └─────────────┘
                          │
                          ▼
                    ┌─────────────┐
                    │ MCP Manager │
                    │ (External   │
                    │  Servers)   │
                    └─────────────┘

高度な使用方法

カスタムツールの作成

1. ツールを追加（特権モードが必要）

tcl-mcp-server run sbin__tcl_tool_add '{
  "user": "dev",
  "package": "math",
  "name": "fibonacci",
  "version": "1.0",
  "description": "フィボナッチ数を計算する",
  "script": "proc fib {n} { if {$n <= 1} {return $n} else {return [expr {[fib [expr {$n-1}]] + [fib [expr {$n-2}]]}]} }; return [fib $n]",
  "parameters": [
    {
      "name": "n",
      "description": "フィボナッチ数を計算する数",
      "required": true,
      "type_name": "integer"
    }
  ]
}'

2. ツールを使用

tcl-mcp-server run user__dev__math__fibonacci '{"n": 10}'

ランタイム機能の検出

インテリジェントなコード生成のためにランタイム機能をクエリします。

tcl-mcp-server run tcl_runtime_info '{
  "include_examples": true,
  "category_filter": "safe"
}'

ランタイム機能比較

コンテナデプロイメント

FROM rust:1.70 as builder
WORKDIR /app
COPY . .
RUN cargo build --release

FROM debian:bookworm-slim
COPY --from=builder /app/target/release/tcl-mcp-server /usr/bin/
COPY --from=builder /app/target/release/tcl-mcp-server-admin /usr/bin/
CMD ["/usr/bin/tcl-mcp-server"]

テスト

# テストスイートを実行
./scripts/run_mcp_tests.sh

# 特定の機能をテスト
python3 tests/test_bin_exec_tool_mcp.py

データストレージ

サーバーの設定は、プラットフォームに適した場所に保存されます。

• Linux：~/.local/share/tcl-mcp-server/
• macOS：~/Library/Application Support/tcl-mcp-server/
• Windows：%APPDATA%\tcl-mcp-server\

トラブルシューティング

一般的な問題

サーバーが起動しない場合

# ランタイムの可用性を確認
tcl-mcp-server --runtime molt --privileged

# デバッグログを有効にする
RUST_LOG=debug tcl-mcp-server

MCPサーバーの接続が失敗する場合

# 接続性をテスト
tcl-mcp-server mcp ping server-id

# サーバーログを確認
TCL_MCP_DEBUG_STDERR=1 tcl-mcp-server

ツールが見つからない場合

# 利用可能なツールをリスト表示
tcl-mcp-server list

# 特定の名前空間を確認
tcl-mcp-server list --namespace user

コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 新機能のテストを追加します。
4. すべてのテストが通過することを確認します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。