Run Typescript Skills MCP

🚀 運行TypeScript技能MCP服務器

這是一個MCP服務器，它允許AI代理執行TypeScript代碼，並能訪問~/.claude/skills中的模塊化API。

🚀 快速開始

本MCP服務器提供了一個工具：run-skill-code。啟用後，你的AI代理可以執行從~/.claude/skills導入並調用函數的TypeScript代碼。

✨ 主要特性

適用場景

• 快速的編程工作流：你的代理無需反覆調用命令行工具（速度慢且需進行文本解析），可以直接調用TypeScript函數並獲取結構化數據。
• 更豐富的代理功能：如果你在~/.claude/skills中為任務管理、版本控制工作流、數據處理或其他工具構建了TypeScript API，那麼代理可以通過編程方式使用它們。
• 更好的性能：進程內執行比為每個操作生成新進程要快得多。
• 類型安全的交互：你的代理可以獲得具有正確類型的結構化結果，而不是解析文本輸出。

不適用場景

• 安全風險：代碼在進程內執行，具有完整的文件系統訪問權限且沒有沙箱保護。如果你的代理編寫了惡意代碼（或出現錯誤），它將以你的權限運行。
• 用例有限：僅當你在~/.claude/skills中有（或計劃構建）TypeScript API時才有用。如果沒有，這個MCP就沒有價值。
• 信任要求：你必須信任你的AI代理能夠安全地編寫和執行代碼，因為沒有安全保障。
• 開發開銷：你需要自己構建和維護TypeScript API。

適用情況判斷

適合使用的情況：

• 你在~/.claude/skills中有希望代理使用的TypeScript API。
• 你信任你的AI代理能夠安全地執行代碼。
• 你希望實現快速的編程工作流。
• 你能接受安全方面的權衡。

不適合使用的情況：

• 你沒有供代理調用的技能/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服務器可以訪問某個文件，那麼執行的代碼也可以。
• 基於信任：你需要信任你的AI代理編寫的是安全代碼。

此服務器適用於你信任代理並希望快速、以編程方式訪問自己的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 文件。

🔗 相關鏈接

• 模型上下文協議
• Bun運行時