Run Typescript Skills MCP

🚀 TypeScriptスキルMCPサーバーの実行

このMCPサーバーは、AIエージェントが ~/.claude/skills 内のモジュール化されたAPIにアクセスしてTypeScriptコードを実行できるようにするものです。

🚀 クイックスタート

このMCPサーバーは、run-skill-code という1つのツールを提供します。有効にすると、AIエージェントは ~/.claude/skills から関数をインポートして呼び出すTypeScriptコードを実行できます。

✨ 主な機能

このサーバーを利用する理由

• 高速なプログラムワークフロー：エージェントがコマンドラインツールを繰り返し呼び出す（低速でテキスト解析が必要）代わりに、TypeScript関数を直接呼び出して構造化データを取得できます。
• 豊富なエージェント機能：~/.claude/skills 内にタスク管理、バージョン管理ワークフロー、データ処理などのTypeScript APIを構築している場合、エージェントがそれらをプログラム的に利用できます。
• 優れたパフォーマンス：プロセス内での実行は、各操作ごとにプロセスを生成するよりもはるかに高速です。
• 型安全なインタラクション：エージェントは、テキスト出力を解析する代わりに、適切な型を持つ構造化結果を取得します。

このサーバーを利用しない理由

• セキュリティリスク：コードは、完全なファイルシステムアクセスでプロセス内で実行され、サンドボックス化されていません。エージェントが悪意のあるコードを書いた場合（またはミスを犯した場合）、あなたの権限で実行されます。
• 限られたユースケース：~/.claude/skills 内にTypeScript APIがある（または構築する予定がある）場合にのみ有用です。そうでない場合、このMCPは価値がありません。
• 信頼要件：エージェントが安全にコードを書いて実行することを信頼する必要があります。安全策はありません。
• 開発オーバーヘッド：TypeScript APIを自分で構築して維持管理する必要があります。

利用シーン

適しているシーン

• ~/.claude/skills 内にエージェントが利用するTypeScript APIがある
• エージェントが安全にコードを実行することを信頼できる
• 高速なプログラムワークフローが必要
• セキュリティとのトレードオフに慣れている

適していないシーン

• エージェントが呼び出すスキル/APIがない
• プロセス内でのコード実行に不安を感じる
• サンドボックス化またはセキュリティ分離が必要
• コマンドラインツールを好む

📦 インストール

前提条件

• Bun v1.0.0以上

セットアップ

git clone <repository-url>
cd run-typescript-skills-mcp
bun install
bun run build

MCPクライアントの設定

VS Code (.vscode/settings.json)：

{
  "mcp": {
    "servers": {
      "run-typescript-skills": {
        "command": "bun",
        "args": ["/absolute/path/to/run-typescript-skills-mcp/src/mcp-bun.ts"]
      }
    }
  }
}

Claude Desktop：

{
  "mcpServers": {
    "run-typescript-skills": {
      "command": "bun",
      "args": ["/absolute/path/to/run-typescript-skills-mcp/src/mcp-bun.ts"]
    }
  }
}

💻 使用例

基本的な使用法

有効にすると、エージェントは以下のようなTypeScriptコードを実行できます。

import { createTask } from '~/.claude/skills/my-workflow/src/api.js';

const task = await createTask({
  title: "Write documentation",
  priority: 1
});

return task;

エージェントは構造化データを取得します。

{
  "returnValue": { "id": "task-123", "title": "Write documentation", "priority": 1 },
  "stdout": "",
  "stderr": ""
}

🔧 技術詳細

セキュリティモデル

⚠️ 重要提示

• サンドボックス化されていません：コードは、完全なシステムアクセスでプロセス内で実行されます。
• サーバーと同じ権限：MCPサーバーがファイルにアクセスできる場合、実行されるコードも同じです。
• 信頼ベース：エージェントが安全なコードを書くことを信頼しています。

このサーバーは、エージェントを信頼し、独自のTypeScript APIに高速かつプログラム的にアクセスしたい制御された環境を対象としています。信頼できないコードの実行、マルチユーザー環境、または分離が必要な状況には適していません。

開発

bun run build        # TypeScriptをコンパイルする
bun run dist         # 最適化されたバンドルをビルドする
bun test             # テストを実行する
bun run dev          # MCPインスペクターを使用した開発モード

アーキテクチャ

• src/mcp-bun.ts - MCPサーバーのエントリポイント
• src/tools/run-skill-code-mcp.ts - ツールの登録
• src/tools/run-skill-code.ts - パブリックAPI
• src/tools/run-skill-code-impl.ts - 実装

アーキテクチャ上の決定事項については、docs/adr/ を参照してください。

📄 ライセンス

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

リンク

• Model Context Protocol
• Bun Runtime